Fund USD

Endpoints to enable your USD wallet and retrieve account details to receive dollar deposits. Once enabled, the API returns the account number and routing so you can display them in your app and let users send USD to that account.

All endpoints require Authorization: Bearer [TOKEN] and x-api-key.

Endpoint summary

Endpoint	Method	Description
`/profile/wallet-visibility`	PATCH	Enable USD wallet (creates user and wallet if missing)
`/usd/user/wallet`	GET	Get account details for receiving deposits (wire/ACH data)

USD funding flow

Step 1: Enable USD wallet

Call PATCH /profile/wallet-visibility with wallet_info_enabled: true. The system creates your user and USD wallet if they do not exist.

Step 2: Get account details

Call GET /usd/user/wallet to get the account number, routing (wire and ACH), and other account data used for receiving deposits.

Step 3: Display in your app

Consume the response data and display it in your UI so users know where to send USD deposits. Once the transaction is confirmed, the balance is credited automatically.

Step 1: Enable USD wallet

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

PATCH/profile/wallet-visibility

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
wallet_info_enabled	boolean	✓	Enables USD wallet visibility

request.json{
"wallet_info_enabled": true
}

Response

response.json

200 OK - updates profile

Creates your user and USD wallet if they do not already exist.

Step 2: Get account details for deposits

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

GET/usd/user/wallet

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Response

response.json

{
"wallet_name": "user@example.com Wallet",
"wallet_id": "wlt_xyz123",
"rtp_account": "1234567890",
"rtp_routing": "021000021",
"wire_account": "9876543210",
"wire_routing": "026009593",
"ach_account": "5555555555",
"ach_routing": 
"011000015"}

Use these details (account number and routing) in your app so users know where to send USD deposits.

🔒

Sensitive data is stored encrypted on the server and returned only to authorized clients (JWT + x-api-key).

Summary

To fund USD you only need 2 endpoints:

PATCH /profile/wallet-visibility -> Enables your USD wallet (creates user and wallet if missing).
GET /usd/user/wallet -> Gets account details (wire/ACH/routing) to display in your app and receive deposits.

Once a transaction is confirmed, balance is credited automatically in your USD wallet.

Mexico deposits (MXN)How to make payments and withdrawals