POST
/
wallets
/
{walletId}
/
topups
curl --request POST \
  --url https://api.sulu.sh/v0/wallets/{walletId}/topups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "<string>",
  "method": "stripe"
}'
{
  "id": "<string>",
  "object": "topup",
  "walletId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "status": "pending",
  "updatedAt": "2023-11-07T05:31:56Z",
  "amount": "<string>",
  "currency": "<string>",
  "method": "stripe",
  "payload": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

walletId
string
required

ID of the wallet to top up

Body

application/json
amount
string
required

Amount to top up in the currency of the wallet

method
enum<string>
required

Payment method to use for the topup

Available options:
stripe

Response

201
application/json
Topup created successfully
id
string
required

Unique identifier for the topup

object
enum<string>
default:topup
required
Available options:
topup
walletId
string
required

ID of the wallet being topped up

createdAt
string
required

Creation timestamp

status
enum<string>
required

Current status of the topup

Available options:
pending,
failed,
success,
cancelled
updatedAt
string
required

Last update timestamp

amount
string
required

Amount to top up in the smallest currency unit

currency
string
required

Currency of the topup (same as wallet currency)

method
enum<string>
required

Payment method used for the topup

Available options:
stripe
payload
object

Method-specific payload data