The fund endpoint allows customers to fund their account balance via transaction from an external debit card account. 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.
URL
{{card_base_url}}/customer/v1/fund
JSON
{
"amount" : "",
"currency" : "",
"memo" : "",
"cardType" : "",
"cardNumber" : "",
"cardExp" : "",
"cardCvv" : "",
"cardholderFirstname" : "",
"cardholderLastname" : "",
"cardholderCompany" : "",
"cardholderAddress1" : "",
"cardholderAddress2" : "",
"cardholderCity" : "",
"cardholderState" : "",
"cardholderZip" : "",
"cardholderCountry" : "",
"cardholderPhone" : "",
"cardholderEmail" : "",
"saveCard" : "",
}
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 "cardNumber" String Y Credit card number "cardExp" String C; required for cardType of "DEBIT" Card expiration date "cardCvv" String N Card security code (CVV / CVC) "cardholderFirstname" String N Cardholder first name "cardholderLastname" String N Cardholder last name "cardholderCompany" String N Cardholder's company "cardholderAddress1" String N Cardholder's billing address "cardholderAddress2" String N Cardholder's billing address, line 2 "cardholderCity" String N Cardholder's billing city "cardholderState" String; Format: CC N 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 "saveCard" Boolean Y Customer authorization to save card details
Code description Notes DEBIT
Debit card Requires cardExp
JSON
{
"fund" : {
"amount" : "",
"currency" : "",
"memo" : "",
"cardType" : "",
"cardNumber" : "",
"cardExp" : "",
"cvv" : "",
"cardholderFirstname" : "",
"cardholderLastname" : "",
"cardholderCompany" : "",
"cardholderAddress1" : "",
"cardholderAddress2" : "",
"cardholderCity" : "",
"cardholderState" : "",
"cardholderZip" : "",
"cardholderCountry" : "",
"cardholderPhone" : "",
"cardholderEmail" : "",
"saveCard" : "",
},
"transactionId" : "",
"cardToken" : "",
"status": "",
"dateCreated": "",
"dateUpdated": "",
}
(In addition to elements found in the input parameters)
Element Details transactionId UUID payment identifier cardToken Avenu issued card token; set to blank currently 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
code Message 1001 "Missing required field" 1002 "Invalid data structure" 1003 "Invalid data"