1. Security & Authentication
Corpayss
  • API Changelog
  • 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
      POST
    • Get Merchant Payment Detail
      POST
    • Get Pos Batch Summary
      POST
    • Get Pos Batch Detail
      POST
    • 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 Request
        • 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
        • Card To Card Balance Transfer
        • Money Send
        • Load Card Balance
      • Security & Authentication
        • Verify Card
          GET
        • Get Card Pin
          GET
        • Send PIN By SMS
          POST
        • Check Pin
          POST
        • Change Card Pin
          POST
        • Reset Cvv 2 Retry Count
          POST
        • Change 3DS Password
          POST
      • Maintenance & Restrictions
        • Get Card Restriction
        • Card Restriction
        • Card Renewal
      • Deprecated
        • Tokenization
          • Tokenize Card No
        • Get Card Balance Loading Limit
        • Get Card No
        • Get Card Private Info
  • Online Payments
    • Card Payments
      • Non-3DS Payments
        • Create Non-3DS Payment
        • Create Non-3DS Pre-Authorization
        • Create Post Authorization
      • 3DS Payments
        • Create 3DS Payment
        • Create 3DS Pre-Authorization
        • Complete 3DS Payment
      • Refunds & Voids
        • Void Payment
        • Refund Payment
    • Payment Links
      • Create 3DS Payment Link
      • Create Non-3DS Payment Link
    • Payment Queries
      • Check Payment by Token
      • Check Payment by Order ID
      • Check Payment by Process ID
      • List Payments by Order ID
    • Recurring Payments
      • Pause Recurring
      • Resume Recurring
      • Reset Plan To Pending
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cancel Recurring
    • Batch
      • Batch Close
    • DEPRECATED
      • QR Transaction
        • QR Payment CreateQr
      • Installment Inquiry
      • Point Inquiry
  1. Security & Authentication

Change Card Pin

POST
/api/Issuer/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": "52654475uywupl74",
    "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 'https://hilarionapi.corpayss.net//api/Issuer/ChangeCardPin' \
--header 'token: 58ff081d-eba7-4e9c-bfab-3cd51792b96d+202501211205' \
--header 'Content-Type: application/json' \
--data '{
    "CardNo": "52654475uywupl74",
    "PinBlock": "AE4C0E49944B0019",
    "NewPin": "916DE94815024302"
}'

Responses

🟢200OK
application/json
OK
Bodyapplication/json

Example
{
    "ResultObject": {
        "Pin": ""
    },
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalXid": 0
}
Modified at 2026-04-29 20:04:38
Previous
Check Pin
Next
Reset Cvv 2 Retry Count
Built with