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

ObjectTypeRequiredDescription
addr_line_1StringyesLine1 of the shipping address.
addr_line_2StringyesLine2 of the shipping address.
cityStringyesCity of the shipping address
stateStringyesState of the shipping address, in ISO 3166-2
countryStringyesShipping country [ISO 3166-2], Currently only support United States
postal_codeStringyesPostcode 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.

Language