Retrieve a card

REQUEST OBJECT

ObjectTypeRequiredDescription
bidString(32)yesBid 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_noString(32)yesIt is a string of number to uniquely distribute the id to a specific order, which the id is created by merchants.
typeStringyesadd_card
signStringyesEncrypt 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.

Language