Card management
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.
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.
which is used to terminate the card. Unlike the Lock Card API, terminating a card is permanent and unrecoverable.
Card Transaction API
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
Action | Description |
---|---|
Authorization | When new transaction authorized |
Reversed | When transaction void from acquirer side |
Settled | Settled 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.
Wallet API
The Wallet API enables you to create recharge addresses for mainstream blockchains for each user.
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.