Binding - Cards API

If kycRequiredWhileApplyCard is true, you must wait for the kycStatus callback.

Once you receive a success status in the callback, you can proceed to bind the card.

If kycRequiredWhileApplyCard is false, you can directly call the Bind API after applying for the card.

Request

Header Params

Content-Type

string

optional

Default:

application/json

Authorization

string

optional

Default:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Body Params application/json

cardId

string

required

Card Id

cardNumber

string

required

Card number

envelopeNo

string

required

Check if the EnvelopeNoRequired field is required in the program interface.

kyc

object

optional

If the Kycrequirements are null, then KYC information is not needed. However, if the Kycrequirements have a value and kycRequiredWhileApplyCard is false, the KYC information must be provided. In this case, ensure that the required fields are passed based on the program's KYC requirements. Otherwise, KYC information is not required.

firstName

string

optional

First name of the individual

lastName

string

optional

Last name of the individual

gender

integer

optional

Gender (1: male, 2: female)

dob

string

optional

Birthday (yyyy-MM-dd)

nationalityId

string

optional

Nationalityid. Please call the interface /Countries

string

optional

mobileCode

string

optional

Mobile code (country code)

mobile

string

optional

Mobile number

address

string

optional

Residential address

town

string

optional

Town Id Please call the interface /Towns

city

string

optional

City

state

string

optional

State or region

zipCode

string

optional

Postal code

countryId

string

optional

Country Id Please call the interface /Countries

countryIsoThree

string

optional

Countryisothree Please call the interface /Countries

emergencyContact

string

optional

Emergency contact number

docType

integer

optional

Document type (1 for passport)

docId

string

optional

Document ID

frontDoc

string

optional

frontdoc: Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png

backDoc

string

optional

backdoc: Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png

docExpireDate

string

optional

Expiry date of the document

docNeverExpire

integer

optional

Indicates if the document has never expired (0 for no)

handHoldIdPhoto

string

optional

A photo of the user holding their passport and bank card must be encoded in Base64 format and must not exceed 1MB in size. The supported formats are .png, .jpeg, and .jpg.

When performing KYC, the cardTypeId parameter is required only if needPhotoForActiveCard = true. Refer to the needPhotoForActiveCard parameter in the /MerchantInformation/Merchant API for further details.

bioMatric

string

optional

biomatric: Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png

photo

string

optional

photo: Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png

signImage

string

optional

signimage: Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png

Example

{
    "cardId": "5eacfc9c-3c51-4e6c-b286-b4c632e44770",
    "cardNumber": "3566002020360505",
    "envelopeNo": "264",
    "kyc": {
        "firstName": "cameron",
        "lastName": "green",
        "gender": 1,
        "dob": "2000-10-01",
        "nationalityId": "+91",
        "email": "[email protected]",
        "mobileCode": "+91",
        "mobile": "9398889038",
        "address": "hyderbad",
        "town": "Srnagar",
        "city": "city",
        "state": "Ts",
        "zipCode": "500038",
        "countryId": "+91",
        "countryIsoThree": "countryisothree",
        "emergencyContact": "98709870987",
        "docType": 1,
        "docId": "1",
        "frontDoc": "frontimg",
        "backDoc": "backimg",
        "docExpireDate": "2025-10-01",
        "docNeverExpire": 0,
        "handHoldIdPhoto": "10-01-2025",
        "bioMatric": "Finger",
        "photo": "img",
        "signImage": "sigimg"
    }
}

Responses

🟢200OK

text/plain

Success

Body

cardId

string | null

optional

cardId

cardNo

string | null

optional

cardno

status

string | null

optional

status(Success,Failed)

remarks

string | null

optional

Status description

Example

{
    "cardId": "c1b4d39b-7a60-48b7-9bf2-d3fe20d3fdef",
    "cardNo": "6200000000000005",
    "status": "Success",
    "remarks": "CardInProgress"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

🔴501501