Skip to main content

Card management

danger

This API(s) have not public release.

The Card management API lets your issue virtual/physics JCB Card. You can also access real-time transaction details, update card status / limits.

B2B card

All cards are registered under your corporate account, and all of them share a business account balance. However, it allows you to manage the cards' limits by adjusting the card limit in real time.

B2C card

Unlike B2B Cards, with C2C Cards, you can create users via the API (which can have a one-to-one correspondence with the users in your system). Each card is linked to a specific user, and each user has their own balance.

Card API

Create a card

The mode supports passing in B2B or B2C. If it is set to B2C, it is also required to pass in the p_user_id(create a user from User API).

Card number/expiration date/cvv Randomly generated by backend.

info

For security reasons, we do not return card detail data in the standard API, if you need to access the full card information, please view it through the Get Full Card Information API. We strongly discourage you from storing full card information in the database.

Lock a card

If you want to temporarily deactivate the card, then please change the card status to Locked via the card lock API, the Locked status of the card will not allow any transactions.

Unlock a card

If the temporary deactivation is expected to be terminated, then the card can be brought back into normal use via the Unlock Card API.

Terminated a card

If it is decided that the card is no longer to be used, the card is terminated via the Card Termination API.

Edit card limit configure

In addition to specifying the limit policy when creating the card, it can be modified through the Edit Card Limit Configure API. We support 4 different rules at the same time, if you want to disable a rule, set the amount to 0.

  • Transaction: Maximum limit per transaction.
  • Daily: Aggregate limit within a single natural day.
  • Monthly: Aggregate limit within a single natural month.
  • Lifetime: Aggregate limit within whole lifetime.
info

which is used to terminate the card. Unlike the Lock Card API, terminating a card is permanent and unrecoverable.

POST
Create Card
>
PUT
Edit Card Limit Configure
>
GET
Get Card Limit Logs
>
PUT
Card Lock
>
PUT
Card Unlock
>
PUT
Card Termination
>
GET
Get Card
>
GET
Get Card List
>
GET
Card Activation - Exchange Key
>
GET
Card Activation - Set Card Pin And Active
>
GET
Get Full Card Number
>

Card Transaction API

Get card transaction list

GET
Get Card Transaction List
>

Query card transaction histories.

Process 3DS Verification

When a card is used for an online transaction, 3DS verification may be triggered. We support sending the verification code to your server via webhook, and you can then send it to your users in any way you like. We will send the webhook in the following format.

{
"p_business_id": "35cc45cc-c418-4154-8f12-2dda715d0433",
"card_reference_id": "33cc2ca1-b4bf-4516-9962-31c67a885eeb",
"verification_id": "03e69dd9-a70c-4b0f-b084-c0ee077772fb",
"business_name": "speed pay",
"card_num": "356772******8213"
"transaction_currency": "HKD",
"transaction_amount": "-101",
"merchant_id": "666666660057123",
"merchant_country": "HK",
"merchant_city": "",
"merchant_name": "Bindo Simulator Test",
"p_created_at": "2025-03-04T03:32:11.051702Z"
"otp_code": "123456" // Verify Code
}

Realtime Transaction Webhook

If you would like to receive real-time notifications of transactions via webhook, please contact us to configure the webhook url.

For each transaction we will send the following transaction notification:

Actions

ActionDescription
AuthorizationWhen new transaction authorized
ReversedWhen transaction void from acquirer side
SettledSettled an authorized transaction
{
"action": "Authorization",
"card_transaction": {
"id": "33cc2ca1-b4bf-4516-9962-31c67a885eeb",
"p_business_id": "35cc45cc-c418-4154-8f12-2dda715d0433",
"card": "03e69dd9-a70c-4b0f-b084-c0ee077772fb",
"status": "Declined",
"type": "Sales",
"transaction_currency": "HKD",
"transaction_amount": "-101",
"local_currency": "HKD",
"local_amount": "-101",
"final_local_amount": "-101",
"calculated_fee": "0",
"merchant_id": "666666660057123",
"merchant_country": "HK",
"merchant_city": "",
"merchant_name": "Bindo Simulator Test",
"p_created_at": "2025-03-04T03:32:11.051702Z"
}
}

User API

If you need to use B2C Cards, you must use the User API to associate them with your users, and pass in the p_user_id when creating the cards. You must ensure that the submitted eKYC information is accurate.

POST
Create User
>
PUT
Edit User
>
GET
Get User
>
GET
Get Account Balance
>

Wallet API

The Wallet API enables you to create recharge addresses for mainstream blockchains for each user.

POST
Create Wallet
>
GET
Get Wallet
>
GET
Get Wallet List
>
GET
Get Wallet Transaction List
>

Platform Transfer API

The Platform Transfer API enables you to transfer account balances between your users.

Create platform transfer

When initiating a transfer request from User A (sender_party) to User B (receiver_party), the following conditions must be met: The eKYC information is consistent with that submitted during registration. User A has a sufficient balance in the corresponding currency. The status of User A or User B is Active.

The Platform Transfer is completed instantly, with no waiting required.

POST
Create Platform Transfer
>
GET
Get Platform Transfer Transaction List
>