post https://separation-merchant.metaprise.online/index/virtualcard/query
REQUEST OBJECT
| Object | Type | Required | Description |
|---|---|---|---|
| bid | String(32) | yes | Bid is the account number generated by Metaprise for the merchant. It is a string of 32 bits long to uniquely identify the merchant generated by the system. |
| out_trade_no | String(32) | yes | It is a string of number to uniquely distribute the id to a specific order, which the id is created by merchants. |
| type | String | yes | add_card |
| sign | String | yes | Encrypt data according to API ENDPOINTS>>Authentication. |
RESPONSE OBJECT
| Object | Sub Object | Type | Description |
|---|---|---|---|
| result | String | The result of response, 1. success 2. fail | |
| bid | String(32) | generated by Metaprise for the merchant. It is a string of 32 bits long to uniquely identify the merchant generated by the system. | |
| card_num | String(16) | The card number. | |
| cvc | String(4) | The cvc code of this card. | |
| exp_date | String(2) | Expiry date are usually not provided, If the card issuer provides it, we will also synchronize it to you for security. | |
| exp_month | String(2) | Expiry month (2 digits) | |
| exp_year | String(2) | Expiry year (2 digits) | |
| card_status | String | available: The card is valid and usable. writeoff: Card write-off, not available. | |
| card_type | String | 1. One-Time: The virtual card is a one-time card, do not allow repeated refill. 2. Recurring: Allow repeated refill. （Refill api: coming soon） | |
| billing | addr_line1 | String | Billing address: address line 1. |
| addr_line2 | String | Billing address: address line 2. | |
| city | String | Billing address: city. | |
| state | String | Billing address: state. | |
| postal_code | String | Billing address: postal code. | |
| country | String | Billing address: country. | |
| currency | String(3) | The three-letter currency code (ISO 4217) of the card. | |
| balance | int | The remaining amount available on the card. the units are cents. (For example: enter "10088" is "100.88) |
API REFERENCE
FORM DATA
bid string required
Bid is the account number generated by Metaprise for the merchant. It is a string of 32 bits long to uniquely identify the merchant generated by the system.
type string required
add_card: Card issuing.
writeoff: Card write-off.
refill: Card refill.
card_num string
The card number.
out_trade_no string
It is a string of number to uniquely distribute the id to a specific order, which the id is created by merchants.
sign string required
Encrypt data according to API ENDPOINTS>>Authentication.