post https://separation-merchant.metaprise.online/index/physcard/add
REQUEST OBJECT
| Object | Type | Required | Description |
|---|---|---|---|
| bid | String(32) | yes | The 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. |
| currency | String | yes | Provide the three-letter currency code (ISO 4217) of the card you need, we only support USD now. |
| amount | int(32) | yes | Setting your spend limitation, the units are cents. (For example: enter "10088" is "100.88) |
| out_trade_no | String(32) | yes | It is a string of numbers to uniquely distribute the id to a specific order, which the id is created by merchants. |
| sign | String | yes | Encrypt data according to API ENDPOINTS>>Authentication. |
| first_name | String | yes | This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. |
| last_name | String | yes | This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. |
| date_of_birth | yyyy-mm-dd | yes | Birthday of the cardholder |
| addr_line_1 | String | yes | The first line of the billing address Fields that start with address_line provide the address’s most specific details, like street number, street name, and building name. They do not provide less specific details like city, state/province, or country (these details are provided in other fields) |
| addr_line_2 | String | no | The second line of the billing address, if any e.g.: apartment, suite, unit, or building |
| city | String | yes | The billing address’s country e.g.: city, district, suburb, town, or village |
| state | String | yes | State of billing country. in ISO 3166-2 |
| postal_code | String | yes | The billing address’s postal code |
| country | String | yes | Billing country [ISO 3166-2], Currently only support United States |
| phone | String | yes | phone numbers associated with the entity in E.164 format─e.g. +12125551395 ( 'h-2": "Required", "h-3": "Description", ' ) |
| String | yes | the email address | |
| shipping | object | yes | The shipping object of the destination will be shipped |
SHIPPING OBJECT
| Object | Type | Required | Description |
|---|---|---|---|
| addr_line_1 | String | yes | Line1 of the shipping address. |
| addr_line_2 | String | yes | Line2 of the shipping address. |
| city | String | yes | City of the shipping address |
| state | String | yes | State of the shipping address, in ISO 3166-2 |
| country | String | yes | Shipping country [ISO 3166-2], Currently only support United States |
| postal_code | String | yes | Postcode of shipping address |
RESPONSE OBJECT
| Object | Sub Object | Type | Required | Description |
|---|---|---|---|---|
| result | String | yes | The result of response, 1. success 2. fail | |
| error | String | no | ||
| error_code | String | no | ||
| data | Object | yes | ||
| 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. | |
| card_id | String(32) | yes | This is a unique identification number issued by Metaprise | |
| 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. | |
| status | String | yes | received: Metaprise has received your apply card request. fail: Your request has been declined by Metaprise or Channel. | |
| card_num | String | no | card number | |
| cvc | String | no | ||
| exp_month | String | no | ||
| exp_year | String | no | ||
| card_type | String | no | One-Time, Recurring, Per_authorization |
{
"result":"fail",
"error":"Balance not enough",
"error_code":"balance_not_enough"
}
{
"result":"fail",
"error":"Your request contains invalid parameter, out_trade_no(ASD123007891) duplicate",
"error_code":"out_trade_no_duplicate"
}
{
"result": "success",
"data": {
"bid": "py_live_SBNS6pHlkjsdfsM1RWzHpbgK3I",
"out_trade_no": "Spapi20sd08890012112121",
"status": "Pending Activation",
"card_num": "0511",
"exp_month": "02",
"exp_year ": "2026",
"card_type": "Per_authorization"
}
}
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.
currency string required
Provide the three-letter currency code (ISO 4217) of the card you needed, we only support USD now.
amount int32 required
Setting your spend limitation, the units are cents. (For example: enter "10088" is "100.88)
out_trade_no string required
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.
Responses