customer/v1/token/fund

[POST] customer/v1/token/fund

Fund account via tokenized debit card

The tokenized fund endpoint allows customers to fund their account balance via transaction from an external debit card account. The card details are tokenized first, before being passed in the POST call as "paymentToken". The "cardType" for this transaction must be "TOKEN". Funds are not available immediately, they will display in the customer's current balance, but they require settlement before they display in the customer's available balance. All funding requests are made in the lowest possible denomination of a currency; eg a funding request for $1.00 USD will be sent as 100.

Example [POST] Request

{{card_base_url}}/customer/v1/token/fund

{
        "amount" : "",
        "currency" : "",
        "memo" : "",
        "cardType" : "",
        "paymentToken" : "",
        "cardholderFirstname" : "",
        "cardholderLastname" : "",
        "cardholderCompany" : "",
        "cardholderAddress1" : "", 
        "cardholderAddress2" : "",
        "cardholderCity" : "",
        "cardholderState" : "",
        "cardholderZip" : "",
        "cardholderCountry" : "",
        "cardholderPhone" : "",
        "cardholderEmail" : "",
}

Input Parameters

Parameter	Format	Required	Details
"amount"	Integer	Y	Funding amount in lowest currency e.g. cents
"currency"	String; Three-letter ISO currency code	Y	The transaction currency
"memo"	String	N	The transaction memo
"cardType"	enum	Y	Card type. See below
"paymentToken"	String	Y	Tokenized card information
"cardholderFirstname"	String	Y	Cardholder first name
"cardholderLastname"	String	Y	Cardholder last name
"cardholderCompany"	String	N	Cardholder's company
"cardholderAddress1"	String	Y	Cardholder's billing address
"cardholderAddress2"	String	N	Cardholder's billing address, line 2
"cardholderCity"	String	Y	Cardholder's billing city
"cardholderState"	String; Format: CC	Y	Cardholder's billing state
"cardholderZip"	String	Y	Cardholder's billing zip code
"cardholderCountry"	String; Two-letter ISO 3166. Format: CC	N	Cardholder's billing country
"cardholderPhone"	String	N	Cardholder's billing phone number
"cardholderEmail"	String	N	Cardholder's billing email

Card Types

Code	description	Notes
`TOKEN`	Tokenized debit card information	Requires paymentToken

Example Response

{
    "fund" : {
        "amount" : "",
        "currency" : "",
        "memo" : "",
        "cardType" : "",
        "paymentToken" : "",
        "cardholderFirstname" : "",
        "cardholderLastname" : "",
        "cardholderCompany" : "",
        "cardholderAddress1" : "",
        "cardholderAddress2" : "",
        "cardholderCity" : "",
        "cardholderState" : "",
        "cardholderZip" : "",
        "cardholderCountry" : "",
        "cardholderPhone" : "",
        "cardholderEmail" : "",
    },
    "transactionId" : "",
    "cardToken" : "",
    "status": "",
    "dateCreated": "",
    "dateUpdated": "",
}

Response Elements

(In addition to elements found in the input parameters)

Element	Details
transactionId	UUID payment identifier
cardToken	Tokenized debit card information
status	Status of payment at end of transaction. See Payments Overview.
dateCreated	Transaction processed date in format ISO 8601 YYYY-MM-DD.
dateUpdated	Date of last status update in format ISO 8601 YYYY-MM-DD

Error Codes

code	Message
1001	"Missing required field"
1002	"Invalid data structure"
1003	"Invalid data"