Issue a card

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", ' )
email	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.