Add balance

Add funds to a customer balance by charging the provided payment method.


Authorization Scope

Both the merchant secret key and client secret key are authorized to call this endpoint.


Error Handling

Properly handling errors related to charging a payment method is crucial for a good customer experience and a high conversion rate. See error handling for more information on handling the potential card declines or other payment failures returned from this endpoint.

Path Params
string
required
Body Params
int64
required

The amount to charge the customer's payment method and add to their wallet.

string
required

Three-letter ISO currency code.

string
required

Payment method id to be charged.

boolean

Flag to disable any automated promotions for this transaction, such as reload bonuses.

string

A string reference that can be attached to this transaction for future discoverability.

json

JSON object of string key-value pairs that you can attach to the created transaction.

additionalInfo
object

Additional structured information about this transaction. Does not impact transaction behavior.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json