Skip to main content
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"
}

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.

Example:

"12/2028"

​
cardType
string
required

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

Example:

"Platinum"