Account credit balance transfer

Credits a user's wallet the indicated amount. Fiat or backed token amounts will typically be funded by the publisher's facilitator wallet. Unbacked token amounts will be minted.

Securitytilia_auth
Request
Request Body schema: application/json
required
destination_wallet_id
required
string <= 36 characters

The id of the destination wallet.

amount
required
integer

The amount to transfer to the destination wallet, in the specified currency.

currency
required
string (CurrencyCode) [ 3 .. 10 ] characters

A currency code. May be either an ISO 4217 currency code, or a code representing your in-game token. Must be a supported currency.

reason
required
string

The reason for the account credit. Only "goodwill" or "promo" are allowed here.

reference_type
string

A type for your reference_id.

reference_id
string

Your own reference ID for this account credit balance transfer.

metadata
string

An arbitrary data structure associated with this balance transfer.

Responses
200

Successfully performed account credit request.

400

Invalid request.

401

Unauthorized access.

500

Service unavailable or server error.

post/v1/account-credit
Request samples
application/json
{
  • "destination_wallet_id": "wal_2V2cKKqYoaj018K0EXBauwcurbd",
  • "amount": 250,
  • "currency": "string",
  • "reason": "goodwill",
  • "reference_type": "string",
  • "reference_id": "string",
  • "metadata": "string"
}
Response samples
application/json
{
  • "status": "Success",
  • "message": [ ],
  • "codes": [ ],
  • "payload": {
    }
}