curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/simulateDeposit/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentMethodType": "bank_transfer",
"amount": 2100,
"alias_or_cvu": "1573308578877835214906"
}
'{
"code": 123,
"type": "<string>",
"detail": {
"message": "<string>"
},
"status": 123
}{
"code": 40001,
"type": "NotAuthenticated",
"detail": {
"message": "Authentication credentials were not provided.",
"code": "not_authenticated"
},
"status": 401
}Simulate Deposit for On-Ramp (Sandbox)
Simulates a fiat deposit for an on-ramp transaction in the sandbox environment. Valid for ARS, MXN, and COP currencies with bank_transfer paymentMethodType, and for BRL with pix paymentMethodType.
This endpoint exists only in sandbox — it is not routed in production.
curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/simulateDeposit/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentMethodType": "bank_transfer",
"amount": 2100,
"alias_or_cvu": "1573308578877835214906"
}
'{
"code": 123,
"type": "<string>",
"detail": {
"message": "<string>"
},
"status": 123
}{
"code": 40001,
"type": "NotAuthenticated",
"detail": {
"message": "Authentication credentials were not provided.",
"code": "not_authenticated"
},
"status": 401
}paymentMethodType and amount depends on the customer’s country. Use the value returned in fiatPaymentInstructions from the Create On-Ramp Session or Create On-Ramp Order response.
| Country | paymentMethodType | Field to send | Source in fiatPaymentInstructions |
|---|---|---|---|
| Argentina (ARS) | bank_transfer | alias_or_cvu | cvu / alias |
| Mexico (MXN) | bank_transfer | clabe | clabe |
| Colombia (COP) | bank_transfer | payment_url | paymentUrl |
| Brazil (BRL) | pix | brcode | brCode |
brCode from Create On-Ramp Order — there is no reusable deposit account to provision first, and pix is not available through an On-Ramp Session. See Brazil (PIX).{}), so don’t try to parse the response as JSON.Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Body
Details for simulating the deposit.
The payment method type for the simulated deposit.
"bank_transfer"
The amount of fiat to send.
2100
Alias or CVU to which the deposit will be made (from onramp fiatPaymentInstructions). Used for ARS deposits.
"0100000000000000000001"
CLABE to which the deposit will be made (from onramp fiatPaymentInstructions). Used for MXN deposits.
"706180196550550550"
Payment URL to identify the order (from onramp fiatPaymentInstructions). Used for COP deposits.
"https://example.com/payment/abc123"
BR Code from the order's fiatPaymentInstructions, which identifies the PIX payment to simulate. Used for BRL deposits with paymentMethodType: pix.
"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD"
Response
Deposit simulation successful. The response has no body at all — a zero-length payload, not {}. Do not try to parse it as JSON.
Was this page helpful?