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.
BR Code from the order's fiatPaymentInstructions, which identifies the PIX payment to simulate. Used for BRL deposits with paymentMethodType: pix.
"00020101021226650014br.gov.bcb.pix2543pix.example.com/v2/invoice/57301741758054405204000053039865802BR5912Example Ltda6009Sao Paulo62280524invoice/573017417580544063041D78"
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?