Create Sell and Pay transaction

curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/sellAndPays/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
  "externalRef": "sp-12345-2024",
  "qrCode": "00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD",
  "paymentCurrency": "ARS",
  "depositCurrency": "USDC",
  "depositNetwork": "ETHEREUM",
  "refundAddress": "0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32"
}
'

import requests

url = "https://skala-sandbox.ripio.com/api/v1/sellAndPays/"

payload = {
    "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
    "externalRef": "sp-12345-2024",
    "qrCode": "00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD",
    "paymentCurrency": "ARS",
    "depositCurrency": "USDC",
    "depositNetwork": "ETHEREUM",
    "refundAddress": "0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32"
}
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({
    customerId: 'b6cecc1f-c90d-424b-adaa-c82b780696c1',
    externalRef: 'sp-12345-2024',
    qrCode: '00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD',
    paymentCurrency: 'ARS',
    depositCurrency: 'USDC',
    depositNetwork: 'ETHEREUM',
    refundAddress: '0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32'
  })
};

fetch('https://skala-sandbox.ripio.com/api/v1/sellAndPays/', 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/sellAndPays/",
  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([
    'customerId' => 'b6cecc1f-c90d-424b-adaa-c82b780696c1',
    'externalRef' => 'sp-12345-2024',
    'qrCode' => '00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD',
    'paymentCurrency' => 'ARS',
    'depositCurrency' => 'USDC',
    'depositNetwork' => 'ETHEREUM',
    'refundAddress' => '0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32'
  ]),
  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/sellAndPays/"

	payload := strings.NewReader("{\n  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\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/sellAndPays/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://skala-sandbox.ripio.com/api/v1/sellAndPays/")

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  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\n}"

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

{
  "id": "a3b2c1d0-1234-5678-90ab-cdef12345678",
  "createdAt": "2024-01-26T12:45:00.078230Z",
  "expiresAt": "2024-01-26T13:45:00.078230Z",
  "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
  "trade": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "externalRef": "<string>",
    "customerId": "<string>",
    "quoteId": "<string>",
    "txnId": "<string>",
    "baseAsset": "<string>",
    "quoteAsset": "<string>",
    "baseAmount": "<string>",
    "quoteAmount": "<string>",
    "rate": "<string>",
    "marketRate": "<string>",
    "chargedFee": "<string>",
    "cryptoChargedFee": "<string>",
    "deferredChargedFee": "<string>",
    "feeChargedInFiat": "<string>"
  },
  "paymentOrder": {
    "id": "<string>",
    "customerId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "merchant": "<string>",
    "qrCode": "<string>",
    "amount": "<string>",
    "currency": "<string>",
    "providerTxnId": "<string>"
  },
  "amount": "10000.50",
  "cryptoAmount": "10.25",
  "paymentCurrency": "ARS",
  "depositCurrency": "USDC",
  "depositNetwork": "ETHEREUM",
  "depositAddress": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
  "cryptoDeposit": {
    "id": "<string>",
    "txnId": "<string>",
    "hash": "<string>",
    "currencyCode": "<string>",
    "addressDestination": "<string>",
    "confirmationDate": "2023-11-07T05:31:56Z",
    "amount": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "customerId": "<string>",
    "status": "<string>",
    "network": "<string>"
  },
  "status": "PENDING",
  "refundAddress": "<string>",
  "refundTxnHash": "0xdef789abc456..."
}

Sell and Pay

Create Sell and Pay transaction

Creates a new Sell and Pay transaction for converting cryptocurrency to fiat currency and paying a merchant via QR code. This endpoint automatically cancels any existing Sell and Pay transactions for the same customer. If all required fields are provided (customerId, externalRef, qrCode, paymentCurrency, depositCurrency, depositNetwork, and refundAddress), the transaction will be created with status PENDING. If any required fields are missing, the transaction will be created with status INCOMPLETE and must be completed using the update endpoint.

POST

api

sellAndPays

curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/sellAndPays/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
  "externalRef": "sp-12345-2024",
  "qrCode": "00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD",
  "paymentCurrency": "ARS",
  "depositCurrency": "USDC",
  "depositNetwork": "ETHEREUM",
  "refundAddress": "0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32"
}
'

import requests

url = "https://skala-sandbox.ripio.com/api/v1/sellAndPays/"

payload = {
    "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
    "externalRef": "sp-12345-2024",
    "qrCode": "00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD",
    "paymentCurrency": "ARS",
    "depositCurrency": "USDC",
    "depositNetwork": "ETHEREUM",
    "refundAddress": "0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32"
}
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({
    customerId: 'b6cecc1f-c90d-424b-adaa-c82b780696c1',
    externalRef: 'sp-12345-2024',
    qrCode: '00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD',
    paymentCurrency: 'ARS',
    depositCurrency: 'USDC',
    depositNetwork: 'ETHEREUM',
    refundAddress: '0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32'
  })
};

fetch('https://skala-sandbox.ripio.com/api/v1/sellAndPays/', 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/sellAndPays/",
  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([
    'customerId' => 'b6cecc1f-c90d-424b-adaa-c82b780696c1',
    'externalRef' => 'sp-12345-2024',
    'qrCode' => '00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD',
    'paymentCurrency' => 'ARS',
    'depositCurrency' => 'USDC',
    'depositNetwork' => 'ETHEREUM',
    'refundAddress' => '0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32'
  ]),
  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/sellAndPays/"

	payload := strings.NewReader("{\n  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\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/sellAndPays/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://skala-sandbox.ripio.com/api/v1/sellAndPays/")

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  \"customerId\": \"b6cecc1f-c90d-424b-adaa-c82b780696c1\",\n  \"externalRef\": \"sp-12345-2024\",\n  \"qrCode\": \"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD\",\n  \"paymentCurrency\": \"ARS\",\n  \"depositCurrency\": \"USDC\",\n  \"depositNetwork\": \"ETHEREUM\",\n  \"refundAddress\": \"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"\n}"

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

{
  "id": "a3b2c1d0-1234-5678-90ab-cdef12345678",
  "createdAt": "2024-01-26T12:45:00.078230Z",
  "expiresAt": "2024-01-26T13:45:00.078230Z",
  "customerId": "b6cecc1f-c90d-424b-adaa-c82b780696c1",
  "trade": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "externalRef": "<string>",
    "customerId": "<string>",
    "quoteId": "<string>",
    "txnId": "<string>",
    "baseAsset": "<string>",
    "quoteAsset": "<string>",
    "baseAmount": "<string>",
    "quoteAmount": "<string>",
    "rate": "<string>",
    "marketRate": "<string>",
    "chargedFee": "<string>",
    "cryptoChargedFee": "<string>",
    "deferredChargedFee": "<string>",
    "feeChargedInFiat": "<string>"
  },
  "paymentOrder": {
    "id": "<string>",
    "customerId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "merchant": "<string>",
    "qrCode": "<string>",
    "amount": "<string>",
    "currency": "<string>",
    "providerTxnId": "<string>"
  },
  "amount": "10000.50",
  "cryptoAmount": "10.25",
  "paymentCurrency": "ARS",
  "depositCurrency": "USDC",
  "depositNetwork": "ETHEREUM",
  "depositAddress": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
  "cryptoDeposit": {
    "id": "<string>",
    "txnId": "<string>",
    "hash": "<string>",
    "currencyCode": "<string>",
    "addressDestination": "<string>",
    "confirmationDate": "2023-11-07T05:31:56Z",
    "amount": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "customerId": "<string>",
    "status": "<string>",
    "network": "<string>"
  },
  "status": "PENDING",
  "refundAddress": "<string>",
  "refundTxnHash": "0xdef789abc456..."
}

Country support

Country	`paymentCurrency`	Payment rail	Fiat account required
Argentina	`ARS`	QR	Yes — pre-create with `POST /sellAndPays/fiatAccounts/`
Colombia	`COP`	BREB-QR	No — calling `POST /sellAndPays/fiatAccounts/` for a Colombian customer returns `400 SellAndPayFiatAccountNotRequiredException`

Both fixed-amount and open-amount QR codes are supported in every country. With an open-amount QR, the customer (or partner) provides the amount via the update endpoint before executing.

Sandbox QR Codes — Argentina

For the sandbox environment, there are several QR codes available to simulate different transaction flows:

valid-qr-code-with-amount

Use this QR code to simulate a successful payment flow with a random amount included in the QR code.

valid-qr-code-without-amount

Use this QR code to simulate a successful payment flow where the amount is not included in the QR code and must be specified separately.

invalid-qr-code

Use this QR code to simulate an error flow when scanning an invalid or malformed QR code.

valid-qr-code-with-blocked-deposit

Use this QR code to simulate a scenario where the deposit destination is blocked or unavailable.

valid-qr-code-with-slippage

Use this QR code to simulate a payment flow that experiences slippage, where the final amount differs from the expected amount.

Sandbox QR Codes — Colombia (BREB-QR)

Use the strings below as the qrCode value in the sandbox environment:

Fixed-amount QR (COP 100)

Use this QR code to simulate a successful BREB-QR payment with a fixed amount already encoded in the QR.

00020101021126320014CO.COM.CRB.LLA0410@CBI8UE7BZ49250014CO.COM.CRB.RED0103CRB5204000053031705406100.005802CO5909Ripio-PXT6006BOGOTA610611022185260014CO.COM.CRB.INC01040.0090430016CO.COM.CRB.TRXID0119P23e46ff8985de4a29091860014CO.COM.CRB.SEC01643c89cda78bcd348f723c55cd91cc9d65b9478378d2bed60accb5f09b0f361aa180290016CO.COM.CRB.CANAL0105ECOMM81250015CO.COM.CRB.CIVA01020382260014CO.COM.CRB.IVA01040.0083270015CO.COM.CRB.BASE01040.0084250015CO.COM.CRB.CINC01020363042617

Open-amount QR

Use this QR code to simulate a successful BREB-QR payment without a pre-defined amount. The amount must be supplied via the update endpoint before executing.

00020101021126320014CO.COM.CRB.LLA0410@CBI8UE7BZ49250014CO.COM.CRB.RED0103CRB5204000053031705802CO5909Ripio-PXT6006BOGOTA610611022185260014CO.COM.CRB.INC01040.0090430016CO.COM.CRB.TRXID0119P23e46ff8985de4a29091860014CO.COM.CRB.SEC01643c89cda78bcd348f723c55cd91cc9d65b9478378d2bed60accb5f09b0f361aa180290016CO.COM.CRB.CANAL0105ECOMM81250015CO.COM.CRB.CIVA01020382260014CO.COM.CRB.IVA01040.0083270015CO.COM.CRB.BASE01040.0084250015CO.COM.CRB.CINC01020363044E9E

Authorizations

Authorization

string

header

required

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

Body

application/json

customerId

string<uuid>

required

Unique identifier of the customer initiating the Sell and Pay transaction. Must be a valid customer registered in the system and associated with the account.

Example:

"b6cecc1f-c90d-424b-adaa-c82b780696c1"

externalRef

string

required

External reference identifier for tracking purposes. This can be used to correlate the transaction with external systems or partner records.

Maximum string length: 250

Example:

"sp-12345-2024"

qrCode

string

required

QR code data containing the payment information for the merchant. This includes payment details such as recipient information and amount to be paid in fiat currency.

Minimum string length: 1

Example:

"00020101021226360014BR.GOV.BCB.PIX0114+55119876543215204000053039865802BR5913Store Name XYZ6009SAO PAULO62070503***6304ABCD"

paymentCurrency

enum<string>

required

Fiat currency in which the payment will be made to the merchant. Must be one of the supported fiat currencies. Use ARS for Argentina QR payments and COP for Colombia BREB-QR payments.

Available options:

ARS,

COP

Example:

"ARS"

depositCurrency

string

Cryptocurrency that will be deposited by the customer (e.g., BTC, ETH, USDC). If not specified, the system may use default settings or require it during execution.

Maximum string length: 10

Example:

"USDC"

depositNetwork

string

Blockchain network for the cryptocurrency deposit (e.g., ETHEREUM, POLYGON, BITCOIN). Required when depositCurrency is provided. Must be a valid network supported for the specified deposit currency.

Maximum string length: 128

Example:

"ETHEREUM"

refundAddress

string

Cryptocurrency address to which funds should be refunded if the transaction fails or is cancelled. Should be a valid address on the deposit network.

Maximum string length: 255

Example:

"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32"

Response

Sell and Pay transaction successfully created

string

Unique identifier for the Sell and Pay transaction assigned by the B2B Service

Example:

"a3b2c1d0-1234-5678-90ab-cdef12345678"

createdAt

string<date-time>

Timestamp when the Sell and Pay transaction was created in ISO 8601 format

Example:

"2024-01-26T12:45:00.078230Z"

expiresAt

string<date-time>

Timestamp when the transaction will expire if not completed in ISO 8601 format. After expiration, cryptocurrency deposits will not be processed.

Example:

"2024-01-26T13:45:00.078230Z"

customerId

string<uuid>

Unique identifier of the customer who initiated the transaction

Example:

"b6cecc1f-c90d-424b-adaa-c82b780696c1"

trade

object | null

Trade execution details. This will be null until the trade is executed and contains information about the cryptocurrency-to-fiat conversion.

Show child attributes

paymentOrder

object | null

Payment order details for the merchant payment. Contains information about the QR code payment and merchant details.

Show child attributes

amount

string

Payment amount in fiat currency to be paid to the merchant

Example:

"10000.50"

cryptoAmount

string

Amount of cryptocurrency required to complete the payment, calculated based on current exchange rates and fees

Example:

"10.25"

paymentCurrency

string

Fiat currency code for the payment (e.g., ARS, MXN, USD)

Example:

"ARS"

depositCurrency

string

Cryptocurrency code for the deposit (e.g., BTC, ETH, USDC)

Example:

"USDC"

depositNetwork

string

Blockchain network identifier for the cryptocurrency deposit (e.g., ETHEREUM, POLYGON, BITCOIN)

Example:

"ETHEREUM"

depositAddress

string

Cryptocurrency address where the customer should send the deposit. This is a unique address generated for this transaction.

Example:

"0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"

cryptoDeposit

object | null

Information about the cryptocurrency deposit made by the customer. This will be null until a deposit is detected on the blockchain.

Show child attributes

status

enum<string>

Current status of the Sell and Pay transaction. INCOMPLETE: missing required fields. PENDING: ready to execute. WAITING_DEPOSIT: executed and ready to receive crypto deposit. RECEIVED_DEPOSIT: crypto deposit detected on blockchain. CONFIRMED_DEPOSIT: crypto deposit confirmed. TRADE_COMPLETED: cryptocurrency successfully converted to fiat. QR_EXECUTION_PENDING: preparing payment to merchant. COMPLETED: payment successfully made to merchant. CANCELED: transaction cancelled. REFUND_PENDING: refund being processed. REFUNDED: funds refunded to customer.

Available options:

INCOMPLETE,

PENDING,

WAITING_DEPOSIT,

RECEIVED_DEPOSIT,

CONFIRMED_DEPOSIT,

TRADE_COMPLETED,

QR_EXECUTION_PENDING,

COMPLETED,

CANCELED,

REFUND_PENDING,

REFUNDED

Example:

"PENDING"

refundAddress

string | null

Cryptocurrency address for refunds in case of transaction failure or cancellation

refundTxnHash

string | null

Transaction hash for the refund transaction on the blockchain. Present when a refund has been processed.

Example:

"0xdef789abc456..."

Create fiat account for sell and pay Update Sell and Pay transaction

⌘I

​Country support

​Sandbox QR Codes — Argentina

​valid-qr-code-with-amount

​valid-qr-code-without-amount

​invalid-qr-code

​valid-qr-code-with-blocked-deposit

​valid-qr-code-with-slippage

​Sandbox QR Codes — Colombia (BREB-QR)

​Fixed-amount QR (COP 100)

​Open-amount QR

Authorizations

Body

Response

Country support

Sandbox QR Codes — Argentina

valid-qr-code-with-amount

valid-qr-code-without-amount

invalid-qr-code

valid-qr-code-with-blocked-deposit

valid-qr-code-with-slippage

Sandbox QR Codes — Colombia (BREB-QR)

Fixed-amount QR (COP 100)

Open-amount QR