Open a receive account
Open a dedicated receiving CLABE for a payer. Opening takes a few minutes. Call this endpoint when the payer registers or is linked. Do not wait until payment time to open the account.
This endpoint is idempotent. Repeated calls with the same payerId return the current status of the same receive account and do not open another account. Idempotency-Key is not required.
Opening an account does not require payer KYC. You submit KYC when you create an order.
This release does not push notifications for opening results. Use the Retrieve a receive account endpoint, and wait at least 1 minute between requests.
The receive account does not expire. All future orders for the same payer use this CLABE.
bearerAuthAuthorizationBearer <token>The access_token obtained from POST /oauth2/token. Header format: Authorization: Bearer {accessToken}. The merchant identity comes from the token. The request body does not accept merchant or tenant fields.
application/json- body
payerId*stringUnique payer identifier on the merchant side. Generated by the merchant, 1 to 64 characters, letters, digits, _, and - only. Do not use personal information such as email addresses, phone numbers, or ID numbers
^[A-Za-z0-9_-]{1,64}$fiatCurrency*"MXN"Fixed to MXN
"MXN"Returns the current status of the receive account.
application/json- response
code?integerBusiness status code
message?stringtraceId?stringRequest trace ID. Provide it when you contact technical support
data?Payer's receive account. Opening and retrieving a receive account use the same structure.
curl -X POST 'https://api.test.stabofx.com/openapi/v1/collections/on-ramp/receive-accounts' \ -H 'Content-Type: application/json' \ -d '{ "payerId": "payer-0001", "fiatCurrency": "MXN"}'{ "code": 200, "message": "OK", "traceId": "trace-uuid-string", "data": { "payerId": "payer-0001", "fiatCurrency": "MXN", "paymentMethod": "SPEI", "status": "PENDING", "clabe": null }}