Request a virtual account for a customer
Issues a virtual account (bank details) for one of your customers in one fiat currency, and returns it. The bank account is issued in your customer's name, so their payers see their name when they pay.
Money a payer sends to a customer's account lands in your balance in that currency. ryno keeps no balance for your customer: you track what you owe each customer.
Asking again for the same customer and currency returns the account already issued, so this call needs no Idempotency-Key. Your customer must be active. The currency must be an active fiat currency with a bank rail for you. Your own accounts are issued when your wallet is set up, so customerId is required.
Body
customerIduuidrequiredOne of your customers. Another partner's customer, a customer still being verified, and your own customer id all return 404 partner..
currencystringrequiredA currency code of 3 or 4 characters, for example NGN. Case does not matter. Only active fiat currencies can be issued: a crypto code such as USDT returns 400 partner..
Response
valueobjectThe customer's account in that currency.
Errors
| Code | HTTP | Meaning |
|---|---|---|
Request. | 400 | The body is not valid JSON, or customerId is not a uuid. |
partner. | 400 | customerId is missing. |
partner. | 400 | currency is missing, not 3 or 4 characters, unknown, switched off, or not a fiat currency. |
partner. | 400 | No bank rail can issue a permanent account in this currency for you. Contact support. |
partner. | 400 | Your balance in this currency is not active. Contact support. |
Auth. | 401 | The token is missing or invalid. |
Auth. | 403 | The token is not a partner credential, or lacks partner.. |
partner. | 403 | Your partner account is not active. Contact support. |
partner. | 403 | The customer is suspended or closed. Their accounts can still be listed. |
partner. | 404 | No customer of yours has that id. |
partner. | 404 | Your partner account could not be found. Contact support. |
partner. | 503 | No bank partner could issue an account right now. Nothing was issued; ask again later. |
The 401, 429 and 503 responses from the API gateway use a different body. See Errors. A 500 is problem details, not this envelope.