Change Fiat Account and Reprocess

curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalFiatAccountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'

import requests

url = "https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/"

payload = { "externalFiatAccountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
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({externalFiatAccountId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'})
};

fetch('https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/', 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/offramp/{orderId}/changeFiatAccount/",
  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([
    'externalFiatAccountId' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
  ]),
  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/offramp/{orderId}/changeFiatAccount/"

	payload := strings.NewReader("{\n  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\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/offramp/{orderId}/changeFiatAccount/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/")

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  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"

response = http.request(request)
puts response.read_body

{
  "orderId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "status": "PROCESSING"
}

{
  "code": 20035,
  "type": "InvalidOrderStateException",
  "detail": {
    "message": "Order is in an invalid state for this operation."
  },
  "status": 400
}

{
  "code": 40001,
  "type": "NotAuthenticated",
  "detail": {
    "message": "Authentication credentials were not provided.",
    "code": "not_authenticated"
  },
  "status": 401
}

{
  "code": 40011,
  "type": "ExternalFiatAccountNotFoundException",
  "detail": {
    "message": "External fiat account not found."
  },
  "status": 404
}

Off-Ramp

Change Fiat Account and Reprocess

Points a cancelled off-ramp order at a different destination account and reprocesses the payout. Use it when the order was cancelled because the fiat could not be delivered — failureReason: INVALID_DESTINATION on the order — for example a closed, mistyped or unreachable account.

This is the counterpart of a refund, not an alternative to it. The order must be CANCELLED with its crypto already traded and no payout completed. Because the crypto was already sold there is nothing to send back, so these orders come back with refundable: false and reprocessing to a corrected account is how they are resolved. Orders whose trade never executed are the refundable ones and cannot be reprocessed — see Refunds.

The replacement account must belong to the same customer and its paymentMethodType must match the one the order was created with. A suspended account is accepted and reactivated, which moves the account that was active for that payment method to suspended — see Fiat account lifecycle. The customer’s active off-ramp session is repointed to the new account as well, so later deposits to that session’s addresses are paid there too.

The response is an acknowledgement, not a completed payout: the order returns to PROCESSING and the payout is retried in the background. The deposit and the trade are not replayed, so no OFF-RAMP.DEPOSIT.RECEIVED or OFF-RAMP.TRADE.COMPLETED event is re-sent — you see OFF-RAMP.WITHDRAWAL.PROCESSING → OFF-RAMP.WITHDRAWAL.COMPLETED, or OFF-RAMP.ORDER.CANCELLED again if the new destination also fails. See Off-Ramp Events.

POST

api

offramp

{orderId}

changeFiatAccount

Change Fiat Account and Reprocess

curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalFiatAccountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'

import requests

url = "https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/"

payload = { "externalFiatAccountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
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({externalFiatAccountId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'})
};

fetch('https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/', 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/offramp/{orderId}/changeFiatAccount/",
  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([
    'externalFiatAccountId' => 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
  ]),
  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/offramp/{orderId}/changeFiatAccount/"

	payload := strings.NewReader("{\n  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\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/offramp/{orderId}/changeFiatAccount/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://skala-sandbox.ripio.com/api/v1/offramp/{orderId}/changeFiatAccount/")

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  \"externalFiatAccountId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"

response = http.request(request)
puts response.read_body

{
  "orderId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "status": "PROCESSING"
}

{
  "code": 20035,
  "type": "InvalidOrderStateException",
  "detail": {
    "message": "Order is in an invalid state for this operation."
  },
  "status": 400
}

{
  "code": 40001,
  "type": "NotAuthenticated",
  "detail": {
    "message": "Authentication credentials were not provided.",
    "code": "not_authenticated"
  },
  "status": 401
}

{
  "code": 40011,
  "type": "ExternalFiatAccountNotFoundException",
  "detail": {
    "message": "External fiat account not found."
  },
  "status": 404
}

A cancelled off-ramp order has exactly one way out, and refundable tells you which:

`refundable`	What happened	How to resolve it
`false`	The crypto was already sold and the fiat payout failed	Retry the payout against another account with this endpoint
`true`	The trade never executed, so the crypto is still there	Request a crypto refund

The two never apply to the same order. An order Ripio is still retrying on its own is neither: it reports status: PENDING rather than CANCELLED, is retried against the same account, and this endpoint answers 400 (20035) while that lasts.

Authorizations

Authorization

string

header

required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Path Parameters

orderId

string<uuid>

required

Unique identifier for the order.

Body

application/json

Body of a change-of-destination request for a cancelled off-ramp order.

externalFiatAccountId

string<uuid>

required

Fiat account the payout is retried to. It must belong to the same customer as the order and share its paymentMethodType. An enabled account is used as is; a suspended one is reactivated first.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

The order was repointed to the new account and queued for reprocessing.

Acknowledgement that the order was repointed and queued for reprocessing. The payout itself is retried in the background.

orderId

string<uuid>

Identifier of the off-ramp order being reprocessed.

Example:

"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

status

string

Status the order was moved to. Always PROCESSING.

Example:

"PROCESSING"

⌘I

Overview

Widget integration

API Integration

Change Fiat Account and Reprocess

Authorizations

Path Parameters

Body

Response