Error

A valid request URL is required to generate request examples

{
  "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "bindingStatus": "success",
  "cardFace": "<string>",
  "expirationDate": "12/2028",
  "cardType": "Platinum"
}

{
  "code": "INVALID_CODE",
  "message": "The verification code provided is incorrect or has expired. Please check the code or re-initiate the process (binding or purchase verification) to receive a new code."
}

{
  "code": "VERIFICATION_ID_NOT_FOUND",
  "message": "The provided verification ID was not found. It may correspond to an expired, completed, or non-existent binding request. Please initiate the binding process again if needed."
}

{
  "code": "ALREADY_BOUND",
  "message": "This card is already bound and associated with an account. Binding confirmation cannot be performed again."
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Your request could not be processed due to a server error."
}

Card Binding

Confirm Card Binding

Completes the Card Binding Process

This endpoint finalizes the card binding process by validating the verification code sent to the cardholder.

Submit the verificationId (received from the initial binding request) and the code (verification code received by the cardholder) in the request payload.

Upon successful validation, the assigned cardId will be returned. This ID should be stored securely for all future transactions with this card.

Note: The verification code must be submitted before the codeExpiry timestamp from the initial binding request.

POST

/

partner-connect

/

card-binding

/

confirm

Error

A valid request URL is required to generate request examples

{
  "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "bindingStatus": "success",
  "cardFace": "<string>",
  "expirationDate": "12/2028",
  "cardType": "Platinum"
}

{
  "code": "INVALID_CODE",
  "message": "The verification code provided is incorrect or has expired. Please check the code or re-initiate the process (binding or purchase verification) to receive a new code."
}

{
  "code": "VERIFICATION_ID_NOT_FOUND",
  "message": "The provided verification ID was not found. It may correspond to an expired, completed, or non-existent binding request. Please initiate the binding process again if needed."
}

{
  "code": "ALREADY_BOUND",
  "message": "This card is already bound and associated with an account. Binding confirmation cannot be performed again."
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Your request could not be processed due to a server error."
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

verificationId

string<uuid>

required

Verification ID from the initial card binding request.

Example:

"123e4567-e89b-12d3-a456-426614174000"

code

string

required

The verification code entered by the user.

Example:

"123456"

Response

Card binding confirmed successfully. The card is now bound and ready for transactions.

cardId

string<uuid>

required

The unique identifier (UUID) assigned to the successfully bound card. Store this cardId securely, as it is required to reference this card in all subsequent transaction requests (/verify, /purchase, etc.).

bindingStatus

enum<string>

required

The final status of the card binding request (will be success on successful confirmation).

Available options:

success

cardFace

string<uri>

required

A URL pointing to an image representing the card's brand.

expirationDate

string

required

The expiration date of the bound card in MM/YYYY format.

Pattern: ^\d{2}\/\d{4}$

Example:

"12/2028"

cardType

string

required

The product tier of the card (e.g., Platinum, Gold, World Elite).

Example:

"Platinum"