curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fiatAccountId": "3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f"
}
'import requests
url = "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/"
payload = { "fiatAccountId": "3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({fiatAccountId: '3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f'})
};
fetch('https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'fiatAccountId' => '3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/"
payload := strings.NewReader("{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}"
response = http.request(request)
puts response.read_body{
"refundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"depositUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initiatedBy": "PARTNER"
}{
"refundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"depositUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initiatedBy": "PARTNER"
}{
"code": 20067,
"type": "FiatAccountRequiredForRefundException",
"detail": {
"message": "fiatAccountId is required to refund a deposit for this provider."
},
"status": 400
}{
"code": 40001,
"type": "NotAuthenticated",
"detail": {
"message": "Authentication credentials were not provided.",
"code": "not_authenticated"
},
"status": 401
}{
"code": 20056,
"type": "FiatRefundNotEnabledException",
"detail": {
"message": "Fiat refunds are not enabled for this account."
},
"status": 403
}{
"code": 40004,
"type": "NotFound",
"detail": {
"message": "Not found.",
"code": "not_found"
},
"status": 404
}{
"code": 20057,
"type": "FiatRefundAlreadyExistsException",
"detail": {
"message": "A refund already exists for this deposit."
},
"status": 409
}Request a Fiat Refund
Requests the return of the fiat deposited for an on-ramp order that was cancelled and could not be completed.
Check refundable on the order before calling: it tells you whether a refund can be requested right now. Whether the request must name a destination account is given by refundDestinationRequired — true means fiatAccountId is required (Colombia, where the provider cannot return the money to its origin), false means the money returns to the account the customer paid from and fiatAccountId is rejected.
The request is idempotent: 202 when the refund is registered, 200 when one already exists for the deposit. Once the refund settles you also receive the ON-RAMP.ORDER.REFUNDED webhook event; a rejected request is only visible in the latestRefund block on the order.
See Refunds for the full model.
curl --request POST \
--url https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fiatAccountId": "3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f"
}
'import requests
url = "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/"
payload = { "fiatAccountId": "3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({fiatAccountId: '3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f'})
};
fetch('https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'fiatAccountId' => '3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/"
payload := strings.NewReader("{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fiatAccountId\": \"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f\"\n}"
response = http.request(request)
puts response.read_body{
"refundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"depositUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initiatedBy": "PARTNER"
}{
"refundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"depositUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"initiatedBy": "PARTNER"
}{
"code": 20067,
"type": "FiatAccountRequiredForRefundException",
"detail": {
"message": "fiatAccountId is required to refund a deposit for this provider."
},
"status": 400
}{
"code": 40001,
"type": "NotAuthenticated",
"detail": {
"message": "Authentication credentials were not provided.",
"code": "not_authenticated"
},
"status": 401
}{
"code": 20056,
"type": "FiatRefundNotEnabledException",
"detail": {
"message": "Fiat refunds are not enabled for this account."
},
"status": 403
}{
"code": 40004,
"type": "NotFound",
"detail": {
"message": "Not found.",
"code": "not_found"
},
"status": 404
}{
"code": 20057,
"type": "FiatRefundAlreadyExistsException",
"detail": {
"message": "A refund already exists for this deposit."
},
"status": 409
}403 Forbidden with the error code 20056 (FiatRefundNotEnabledException), and refundable is always false on your orders.Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Headers
Optional. The public IP address of the end user's device (IPv4 or IPv6), captured on your frontend and forwarded by your backend — never your server's own address. Used for traceability and fraud prevention. An address that is not a valid IPv4 or IPv6 discards the end-user context of the request, without failing it. See Forwarding end-user context.
45Optional. The User-Agent of the end user's browser or app, not your backend's HTTP client. Longer values are truncated to 500 characters. See Forwarding end-user context.
500Optional. A stable identifier of the end user's device, as your app or frontend defines it. Longer values are truncated to 200 characters. See Forwarding end-user context.
200Path Parameters
Body
Body of a fiat refund request. Send fiatAccountId only when refundDestinationRequired is true.
Response
A refund already exists for this deposit; nothing new was created.
Acknowledgement of a fiat refund request. The request is idempotent, so a 200 returns whatever refund already existed for the deposit — read initiatedBy before presenting it as the customer's own request.
Current state of the refund: PENDING (registered, not yet sent to the provider), PROCESSING (sent, awaiting confirmation), COMPLETED (the money reached its destination), REJECTED (the request was declined — see rejectionReason — and nothing was sent) or FAILED / CANCELLED (the attempt did not go through; contact Ripio support).
PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED Was this page helpful?