Skip to main content
POST
/
partner-connect
/
card-binding
/
initiate
Error
A valid request URL is required to generate request examples
{
  "verificationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "code": "<string>",
  "codeExpiry": "2023-11-07T05:31:56Z",
  "maskedPan": "545188******0110",
  "contactNumber": 85260001235,
  "cardFace": "<string>"
}

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

The request body MUST contain the customer's full PAN.

​
fullPan
string
required

Full primary account number.

Example:

"5123888812341234"

Response

Card binding process initiated successfully. The response contains the verificationId and code required to complete the binding via the /confirm endpoint, along with card metadata.

​
verificationId
string<uuid>
required

A unique identifier (UUID) representing this specific binding attempt. Store this ID and use it in the /confirm request.

​
code
string
required

The verification code generated for the cardholder. This code MUST be securely obtained from the cardholder (e.g., they enter it into your interface after receiving it via SMS/email) and sent in the /confirm request. Do not log or store this code.

​
codeExpiry
string<date-time>
required

The timestamp (ISO 8601 format) when the verificationId and code expire. The confirmation step must be completed before this time.

​
maskedPan
string
required

The card's PAN, masked for display purposes (e.g., showing only the first 6 and last 4 digits). Useful for showing the customer which card is being bound.

Example:

"545188******0110"

​
contactNumber
string
required

The cardholder's registered contact number (partially masked or full, depending on configuration), typically where the verification code is sent.

Example:

85260001235

​
cardFace
string<url>
required

A URL pointing to an image representing the card's brand (e.g., Visa, Mastercard logo).