Corpayss
  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
      • TheereD Complete 3DS Payment
    • NonSecure
      • Batch Close
      • Payment Sale
      • Payment InstallmentInquiry
      • Payment PointInquiry
      • Payment Pre Sale
      • Payment Post Sale
      • Payment Void
      • Payment Refund
    • QR Transaction
      • QR Payment CreateQr
      • Create Order 3D
    • Inquiry
      • Chek ByToken
      • Chek ByOrderId
      • Chek By ProcessId
      • Chek ListByOrderId
    • Order
      • Order Creat Order
      • Order Creat Order3D
    • Recurring
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cansel Recurring
  • Schemas
    • Schemas
      • Merchant
        • MerchantInfoModel
        • MerchantDataModel
        • MerchantAddressModel
        • MerchantCommunicationModel
        • MerchantContactModel
        • MerchantAccountModel
      • Card
        • CardModel
        • CardRequest
        • CardResponseExample
        • CardTransactionModel
        • CardVerifyModel
        • GetCardInfoModel
        • CreateDebitCardRequest
      • Customer
        • CustomerInfoModel
        • Customer
      • VPOS
      • MerchantSetRequest
      • CardRenewalRequest
      • OrderCreateRequest
      • CustomerBatchCloseRequest
      • StringDataModel
      • BarcodeModel
      • CheckByTokenRequest
      • CheckByOrderIdRequest
      • CheckByProcessIdRequest
      • TokenModel
      • Customer3DSAuthRequest
      • CustomerCashDepositRequest
      • SearchMerchantRequest
      • CardRestrictionRequest
      • TerminalDataModel
      • HostBalanceModel
      • CustomerRefundRequest
      • CustomerVoidRequest
      • CustomerNonSecureAuthRecurringRequest
      • SearchTerminalRequest
      • ProvisionExt
      • CreateMerchantAndTerminalRequest
      • SendPINBySMSModel
      • LongDataModel
      • CreditCustomerDetails
      • CustomerNonSecureAuthRequest
      • CustomerThreeDAuthRequest
      • CustomerThreeDPreAuthRequest
      • CommissionProfileModel
      • CreateCreditCardRequest
      • MrcCommissionProfile
      • CardLimitRates
      • CustomerNonSecurePointAuthRequest
      • MrcCommissionProfileClrDtl
      • CustomerPostAuthRequest
      • MrcCommissionProfileDtl
      • CreatePrepaidCardRequest
      • CustomerPointInquiryRequest
      • MrcCommissionProfileInstDtl
      • CreateEmbossDirectiveRequest
      • MerchantPaymentRequest
      • Customer3DSPreAuthRequest
      • PosBatchSummaryRequest
      • CheckPinRequest
      • PosBatchDetailRequest
      • UpdateCustomerLimitRequest
      • PosBatchCloseRequest
      • UpdateCardLimitRequest
      • ShortDataModel
      • CardStatuUpdateRequest
      • PosAuthProfileModel
      • CardPaymentRequest
      • PosAuthProfile
      • CardRegistrationRequest
      • PosAuthProfileDetail
      • BalanceTransferRequest
      • MrcPosFeeProfileExt
      • CardFeeStatusUpdateRequest
      • MrcPosFeeProfile
      • PinChangeRequest
      • MrcPosFeeProfileDetail
      • Change3DSPasswordRequest
      • MoneySendModel
      • MoneySendReceiver
      • MoneySendSender
      • MoneySendTxnRef
      • MoneySendActorIdentification
      • CustomerNonSecurePreAuthRequest
      • CustomerNonSecurePostAuth
      • CustomerNonSecureRefund
    • Terminal
  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://hilarion.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