Skip to content

Get the settlement wallet​

GET
/v2/payments/collect/settlements/wallet

Requires COLLECTIONS_READ, granted by PAYMENTS_READ or COLLECTIONS_WRITE (bundles)

Returns the crypto wallet your business's collected funds settle to.

Responses​

OK

application/json
JSON
{
"id": "e2a4c6b8-0d1f-4e3a-b5c7-9d1e3f5a7b9c",
"name": "Treasury USDC",
"address": "0x7a2D4c9E1b3F5a8C0d6E2f4B9c1A3e5D7b9F0c2E",
"network": "Ethereum",
"currency": "USDC",
"beneficiaryName": "Acme Trading (Pty) Ltd",
"serviceProviderName": null
}

Samples​

Errors

HTTPErrorWhen
400BAD_REQUESTA query parameter or field is invalid.
403-16098PAYMENTS_USER_ACCESS_NOT_CONFIGUREDPayments haven't been set up for your business yet.
404NOT_FOUNDNo settlement wallet is set up for your business.
500INTERNAL_ERRORUnexpected error in the payments service.
502-16097EXCHANGE_API_ERRORThe payments service failed to process the request.
502EXCHANGE_API_ERRORThe payments service couldn't complete the request. Try again later.
503-16099PAYMENTS_BACKEND_PROXY_DISABLEDPayments endpoints are temporarily unavailable.

Plus the errors common to all signed endpoints.