Retrieve the on-chain address to fund an order.
GET
/api/v1/payments/order/getdepositaddress/{orderId}
chain returned, in thecryptoCurrency returned — a deposit on another chain or in another asset is notrecoverable. Returns 404 both when the order does not belong to the customer and when no
address is available for it, so the response cannot be used to probe which order ids exist.
POST order) and belong to the requesting customer.chain or in the wrong cryptoCurrency cannot be recovered — always fund exactly what this response specifies.POST /api/v1/payments/order; check settlement with GET .../order/{orderId}.📤 Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
data | object | No | The address an order is funded to. This is OUR platform address, never a provider's. The partner deposits here; moving those funds on to whichever provider executes the payout is internal and is not part of this contract. Exposing a provider address would leak which provider serves the corridor and would break the moment that routing changed. |
data.id | string (uuid) | No | The order this address funds — the id passed in the route. Mirrors the id Mesta returns on its deposit-wallet-address response, which identifies the same thing: the address assignment being read. |
data.address | string | Yes | The address to send funds to. |
data.chain | string | Yes | Chain the address is on (e.g. "POLYGON"). Named to match how the providers themselves report it — Mesta's deposit-wallet-address response uses "chain". Sending on a different chain loses the funds, so it is returned with the address rather than left to assume. |
data.cryptoCurrency | string | Yes | Asset expected at this address (e.g. "USDC"). Noah reports the same as CryptoCurrency. |
data.createdAt | string (date-time) | Yes | When the order this address belongs to was created. |
requestId | string | Yes | — |
timestamp | string (date-time) | No | — |
Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/payments/order/getdepositaddress/7a2e4c9b-1f6d-4a3e-8c7b-9d0f2a5e6b18?customerId=c1f4a9d2-6b3e-4a7c-9f1d-2e8b5c0a7d31' \
--header 'X-API-Key: ak_live_8f3a9b2c7e1d4f6a9b0c2d5e8f1a3b6c' \
--header 'X-Signature: kZ3fQeT2m7xVvC9pR1sLdY8bN0hU4jK6oW5aE2gI7cQ=' \
--header 'X-Timestamp: 1758556800' \
--header 'X-Nonce: 3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'X-Body-Hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU='Response Response Example
200 - Success
{
"data": {
"id": "7a2e4c9b-1f6d-4a3e-8c7b-9d0f2a5e6b18",
"address": "0x8f3a2c7e1b9d4f6a9c2e0b7d1f8a3c6e5d2a1b47",
"chain": "POLYGON",
"cryptoCurrency": "USDC",
"createdAt": "2026-09-22T14:02:47Z"
},
"requestId": "req_4f9a2c7e1b8d3f6a9c2e0b7d1f8a3c6e",
"timestamp": "2026-09-22T14:03:11Z"
}Modified at 2026-09-22 10:35:55