1. Security & Authentication
Corpayss
  • Acquirer
    • Merchant
      • Create Merchant
      • Get Merchant
      • Update Merchant
      • Search Merchant
    • Terminal
      • Create Terminal
      • Get Terminal
      • Update Terminal
      • Search Terminal
    • Deprecated - Commission Profile
      • Create Commission Profile
      • Get Commission Profile
      • Update Commission Profile
      • Delete Commission Profile
    • Pos Authorization Profile
      • Create Pos Authorization Profile
      • Get Pos Authorization Profile
      • Update Pos Authorization Profile
      • Delete Pos Authorization Profile
    • Pos Fee Profile
      • Create Pos Fee Profile
      • Get Pos Fee Profile
      • Update Pos Fee Profile
      • Delete Pos Fee Profile
    • Create Merchant and Terminal
      POST
    • Get Merchant Payment Summary
      GET
    • Get Merchant Payment Detail
      GET
    • Get Pos Batch Summary
      GET
    • Get Pos Batch Detail
      GET
    • Close Pos Batch
      POST
  • Issuer
    • Customer
      • Create Customer
      • Get Customer Info
      • Get Card Customer Info
      • Update Customer
      • Update Customer Limit
    • Card
      • Creation & Registration
        • Create Credit Card
        • Create Debit Card
        • Create Prepaid Card
        • Create Emboss Directive
        • Register Card
      • Information & Status Management
        • Get Card Info
        • Get Card Status
        • Get Host Balance
        • Update Card Limit
        • Update Card Status
        • Update Card Fee Status
      • Transactions & Balance Operations
        • Get Card Transactions
        • Send Transaction
        • Load Card Balance
        • Card To Card Balance Transfer
        • Money Send
      • Security & Authentication
        • Verify Card
          GET
        • Get Card Pin
          GET
        • Send PIN By SMS
          POST
        • Check Pin
          POST
        • Change Card Pin
          PATCH
        • Reset Cvv 2 Retry Count
          PATCH
        • Change 3DS Password
          POST
      • Maintenance & Restrictions
        • Get Card Restriction
        • Card Restriction
        • Card Renewal
      • Tokenization
        • Tokenize Card No
      • Deprecated
        • Get Card Balance Loading Limit
        • Get Card No
        • Get Card Private Info
  • VPOS
    • 3DS Transaction
      • ThreeD - Sale
      • ThreeD - Pre Sale
      • ThreeD - Complete 3DS Payment
    • NonSecure
      • Batch Close
      • Payment Sale
      • Installment Inquiry
      • Point Inquiry
      • Payment Pre Sale
      • Payment Post Sale
      • Payment Void
      • Payment Refund
    • QR Transaction
      • QR Payment CreateQr
    • Inquiry
      • Chek ByToken
      • Check By Order ID
      • Chek By Process ID
      • List By Order ID
    • Order
      • Create Order 3D
      • Create Order
    • Recurring
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cancel Recurring
  1. Security & Authentication

Change Card Pin

PATCH
/api/Integration/ChangeCardPin
This service updates the card’s PIN and returns the new PIN in encrypted form. If the PIN block is empty, the provided PIN is set directly without verifying the current PIN.

Request

Header Params

Body Params application/json

Example
{
    "CardNo": "54635400ikinnw41",
    "PinBlock": "AE4C0E49944B0019",
    "NewPin": "916DE94815024302"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://hilarion1.corpayss.net:8422//api/Integration/ChangeCardPin' \
--header 'token: 58ff081d-eba7-4e9c-bfab-3cd51792b96d+202501211205' \
--header 'Content-Type: application/json' \
--data-raw '{
    "CardNo": "54635400ikinnw41",
    "PinBlock": "AE4C0E49944B0019",
    "NewPin": "916DE94815024302"
}'

Responses

🟢200OK
application/json
OK
Body

Example
{
    "ResultObject": {
        "Pin": ""
    },
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalRefNumber": 0
}
Modified at 2025-11-13 19:20:11
Previous
Check Pin
Next
Reset Cvv 2 Retry Count
Built with