Submit Conversion

curl --request POST \
  --url https://api.prod.bastion.com/v2/conversions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET"
  },
  "destination": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>"
  },
  "quote_id": "<string>",
  "device_signals": {
    "ip_address": "<string>",
    "device_id": "<string>"
  }
}
'

import requests

url = "https://api.prod.bastion.com/v2/conversions"

payload = {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "amount": "<string>",
    "account_id": "<string>",
    "payment_purpose": "SALARY_PAYMENT",
    "source": {
        "currency": "USDC",
        "payment_method": "BLOCKCHAIN",
        "chain": "ETHEREUM_MAINNET"
    },
    "destination": {
        "currency": "USDC",
        "payment_method": "BLOCKCHAIN",
        "chain": "ETHEREUM_MAINNET",
        "payment_instructions_id": "<string>"
    },
    "quote_id": "<string>",
    "device_signals": {
        "ip_address": "<string>",
        "device_id": "<string>"
    }
}
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({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    amount: '<string>',
    account_id: '<string>',
    payment_purpose: 'SALARY_PAYMENT',
    source: {currency: 'USDC', payment_method: 'BLOCKCHAIN', chain: 'ETHEREUM_MAINNET'},
    destination: {
      currency: 'USDC',
      payment_method: 'BLOCKCHAIN',
      chain: 'ETHEREUM_MAINNET',
      payment_instructions_id: '<string>'
    },
    quote_id: '<string>',
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/conversions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    amount: '<string>',
    account_id: '<string>',
    payment_purpose: 'SALARY_PAYMENT',
    source: {currency: 'USDC', payment_method: 'BLOCKCHAIN', chain: 'ETHEREUM_MAINNET'},
    destination: {
      currency: 'USDC',
      payment_method: 'BLOCKCHAIN',
      chain: 'ETHEREUM_MAINNET',
      payment_instructions_id: '<string>'
    },
    quote_id: '<string>',
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/conversions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.prod.bastion.com/v2/conversions"

	payload := strings.NewReader("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\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://api.prod.bastion.com/v2/conversions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
  .asString();

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
val request = Request.Builder()
  .url("https://api.prod.bastion.com/v2/conversions")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

import Foundation

let parameters = [
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": [
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET"
  ],
  "destination": [
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>"
  ],
  "quote_id": "<string>",
  "device_signals": [
    "ip_address": "<string>",
    "device_id": "<string>"
  ]
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.prod.bastion.com/v2/conversions")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.prod.bastion.com/v2/conversions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

require 'uri'
require 'net/http'

url = URI("https://api.prod.bastion.com/v2/conversions")

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  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}"

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

{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "amount": "<string>",
    "total": "<string>"
  },
  "destination": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>",
    "amount": "<string>",
    "country": "US"
  },
  "id": "<string>",
  "type": "ON_RAMP",
  "status": "INITIATED",
  "source_deposit_instructions": {
    "amount": "<string>",
    "currency": "USDC",
    "bank_name": "<string>",
    "bank_address": "<string>",
    "payment_method": "BLOCKCHAIN",
    "deposit_message": "<string>",
    "bank_account_number": "<string>",
    "bank_routing_number": "<string>",
    "bank_beneficiary_name": "<string>",
    "bank_beneficiary_address": "<string>"
  },
  "created_at": "<string>",
  "updated_at": "<string>",
  "completed_at": "<string>",
  "exchange_rate": "<string>",
  "fees_total": "<string>",
  "destination_currency": "<string>",
  "fees": [
    {
      "amount": "<string>",
      "currency": "USDC",
      "type": "PLATFORM",
      "fee_percent": "<string>"
    }
  ],
  "fee_model": "INCLUSIVE",
  "fees_total_currency": "USDC",
  "quote_id": "<string>",
  "failure_reason": "<string>",
  "refund_details": {
    "refund_amount": "<string>",
    "transaction_hash": "<string>",
    "deposit_id": "<string>",
    "failure_details": {
      "type": "REFUND_FAILURE_TYPE_BANK_REJECTED",
      "description": "<string>"
    }
  },
  "identity_id": "<string>"
}

POST

conversions

Submit Conversion

curl --request POST \
  --url https://api.prod.bastion.com/v2/conversions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET"
  },
  "destination": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>"
  },
  "quote_id": "<string>",
  "device_signals": {
    "ip_address": "<string>",
    "device_id": "<string>"
  }
}
'

import requests

url = "https://api.prod.bastion.com/v2/conversions"

payload = {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "amount": "<string>",
    "account_id": "<string>",
    "payment_purpose": "SALARY_PAYMENT",
    "source": {
        "currency": "USDC",
        "payment_method": "BLOCKCHAIN",
        "chain": "ETHEREUM_MAINNET"
    },
    "destination": {
        "currency": "USDC",
        "payment_method": "BLOCKCHAIN",
        "chain": "ETHEREUM_MAINNET",
        "payment_instructions_id": "<string>"
    },
    "quote_id": "<string>",
    "device_signals": {
        "ip_address": "<string>",
        "device_id": "<string>"
    }
}
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({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    amount: '<string>',
    account_id: '<string>',
    payment_purpose: 'SALARY_PAYMENT',
    source: {currency: 'USDC', payment_method: 'BLOCKCHAIN', chain: 'ETHEREUM_MAINNET'},
    destination: {
      currency: 'USDC',
      payment_method: 'BLOCKCHAIN',
      chain: 'ETHEREUM_MAINNET',
      payment_instructions_id: '<string>'
    },
    quote_id: '<string>',
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/conversions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    request_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    amount: '<string>',
    account_id: '<string>',
    payment_purpose: 'SALARY_PAYMENT',
    source: {currency: 'USDC', payment_method: 'BLOCKCHAIN', chain: 'ETHEREUM_MAINNET'},
    destination: {
      currency: 'USDC',
      payment_method: 'BLOCKCHAIN',
      chain: 'ETHEREUM_MAINNET',
      payment_instructions_id: '<string>'
    },
    quote_id: '<string>',
    device_signals: {ip_address: '<string>', device_id: '<string>'}
  })
};

fetch('https://api.prod.bastion.com/v2/conversions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.prod.bastion.com/v2/conversions"

	payload := strings.NewReader("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\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://api.prod.bastion.com/v2/conversions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
  .asString();

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}")
val request = Request.Builder()
  .url("https://api.prod.bastion.com/v2/conversions")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

import Foundation

let parameters = [
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": [
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET"
  ],
  "destination": [
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>"
  ],
  "quote_id": "<string>",
  "device_signals": [
    "ip_address": "<string>",
    "device_id": "<string>"
  ]
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.prod.bastion.com/v2/conversions")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.prod.bastion.com/v2/conversions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

require 'uri'
require 'net/http'

url = URI("https://api.prod.bastion.com/v2/conversions")

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  \"request_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"amount\": \"<string>\",\n  \"account_id\": \"<string>\",\n  \"payment_purpose\": \"SALARY_PAYMENT\",\n  \"source\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\"\n  },\n  \"destination\": {\n    \"currency\": \"USDC\",\n    \"payment_method\": \"BLOCKCHAIN\",\n    \"chain\": \"ETHEREUM_MAINNET\",\n    \"payment_instructions_id\": \"<string>\"\n  },\n  \"quote_id\": \"<string>\",\n  \"device_signals\": {\n    \"ip_address\": \"<string>\",\n    \"device_id\": \"<string>\"\n  }\n}"

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

{
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": "<string>",
  "account_id": "<string>",
  "payment_purpose": "SALARY_PAYMENT",
  "source": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "amount": "<string>",
    "total": "<string>"
  },
  "destination": {
    "currency": "USDC",
    "payment_method": "BLOCKCHAIN",
    "chain": "ETHEREUM_MAINNET",
    "payment_instructions_id": "<string>",
    "amount": "<string>",
    "country": "US"
  },
  "id": "<string>",
  "type": "ON_RAMP",
  "status": "INITIATED",
  "source_deposit_instructions": {
    "amount": "<string>",
    "currency": "USDC",
    "bank_name": "<string>",
    "bank_address": "<string>",
    "payment_method": "BLOCKCHAIN",
    "deposit_message": "<string>",
    "bank_account_number": "<string>",
    "bank_routing_number": "<string>",
    "bank_beneficiary_name": "<string>",
    "bank_beneficiary_address": "<string>"
  },
  "created_at": "<string>",
  "updated_at": "<string>",
  "completed_at": "<string>",
  "exchange_rate": "<string>",
  "fees_total": "<string>",
  "destination_currency": "<string>",
  "fees": [
    {
      "amount": "<string>",
      "currency": "USDC",
      "type": "PLATFORM",
      "fee_percent": "<string>"
    }
  ],
  "fee_model": "INCLUSIVE",
  "fees_total_currency": "USDC",
  "quote_id": "<string>",
  "failure_reason": "<string>",
  "refund_details": {
    "refund_amount": "<string>",
    "transaction_hash": "<string>",
    "deposit_id": "<string>",
    "failure_details": {
      "type": "REFUND_FAILURE_TYPE_BANK_REJECTED",
      "description": "<string>"
    }
  },
  "identity_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication with an API token

Body

application/json

request_id

string<uuid>

required

Request identifier in UUID format. Serves as an idempotency key.

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

amount

string

required

Amount to be converted in source currency. Maximum 6 decimal places.

account_id

string

required

Account ID to debit for the conversion.

payment_purpose

enum<string>

required

Purpose of the payment. See Payment purposes for each value's meaning and how to choose one.

Available options:

PAYMENT_PURPOSE_UNSPECIFIED,

SALARY_PAYMENT,

PERSONAL_REMITTANCE,

RENT_PAYMENT,

PROPERTY_PURCHASE,

OWNED_ACCOUNT_ABROAD,

ADVERTISING_EXPENSES,

ADVISORY_FEES,

BUSINESS_INSURANCE,

CONSTRUCTION,

DELIVERY_FEES,

EDUCATION,

EXPORTS,

DONATION,

HOTEL,

LOAN_PAYMENT,

MAINTENANCE_EXPENSES,

MEDICAL_EXPENSE,

OFFICE_EXPENSES,

ROYALTY_FEES,

SERVICE_CHARGE,

SHARES_INVESTMENT,

TAX_PAYMENT,

TRANSPORTATION_FEES,

TRAVEL,

UTILITY_BILLS,

INTERNAL_BUSINESS_MOVEMENT

Example:

"SALARY_PAYMENT"

source

source · object

required

Source of the conversion

Show child attributes

destination

destination · object

required

Destination of the conversion

Show child attributes

quote_id

string

Quote ID from a prior GET /v2/conversions/quotes response. Required for non-US off-ramp conversions. US destinations can omit quote_id.

device_signals

DeviceSignals · object | null

DeviceSignals carries client device/network identifiers captured at request time for value-moving, user-initiated endpoints.

Show child attributes

Response

Success

request_id

string<uuid>

required

Client-provided request_id (UUID). Idempotency key for internal reconciliation only; do not surface on end-user receipts — use id.

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

amount

string

required

Amount in source currency.

account_id

string

required

Account ID debited for the conversion

payment_purpose

enum<string>

required

Purpose of the payment. See Payment purposes for each value's meaning and how to choose one.

Available options:

PAYMENT_PURPOSE_UNSPECIFIED,

SALARY_PAYMENT,

PERSONAL_REMITTANCE,

RENT_PAYMENT,

PROPERTY_PURCHASE,

OWNED_ACCOUNT_ABROAD,

ADVERTISING_EXPENSES,

ADVISORY_FEES,

BUSINESS_INSURANCE,

CONSTRUCTION,

DELIVERY_FEES,

EDUCATION,

EXPORTS,

DONATION,

HOTEL,

LOAN_PAYMENT,

MAINTENANCE_EXPENSES,

MEDICAL_EXPENSE,

OFFICE_EXPENSES,

ROYALTY_FEES,

SERVICE_CHARGE,

SHARES_INVESTMENT,

TAX_PAYMENT,

TRANSPORTATION_FEES,

TRAVEL,

UTILITY_BILLS,

INTERNAL_BUSINESS_MOVEMENT

Example:

"SALARY_PAYMENT"

source

source · object

required

Source configuration

Show child attributes

destination

destination · object

required

Destination configuration

Show child attributes

string

read-only

Server-generated unique conversion ID (KSUID). This is the canonical transaction identifier; use it on end-user receipts and references.

type

enum<string>

Inferred conversion type

Available options:

CONVERSION_TYPE_UNSPECIFIED,

ON_RAMP,

OFF_RAMP

Example:

"ON_RAMP"

status

enum<string>

Current external status of the conversion

Available options:

CONVERSION_STATUS_UNSPECIFIED,

INITIATED,

PROCESSING,

PAYOUT_INITIATED,

PAYOUT_COMPLETED,

COMPLETED,

FAILED,

CANCELLED,

RETURNED

Example:

"INITIATED"

source_deposit_instructions

source_deposit_instructions · object

Deposit instructions for MemoID On-Ramp.

Show child attributes

created_at

string

read-only

Time the conversion was created, as an RFC 3339 timestamp.

updated_at

string

read-only

Time the conversion was last updated, as an RFC 3339 timestamp.

completed_at

string

read-only

Timestamp for when conversion reached terminal COMPLETED status.

exchange_rate

string

read-only

The exchange rate applied to the conversion.

fees_total

string

read-only

Rolled-up total of all fees visible to the end user.

destination_currency

string

read-only

Destination currency symbol (e.g., "USD", "MXN", "KRW").

fees

Fee · object[]

read-only

Itemized fee breakdown.

Show child attributes

fee_model

enum<string>

Fee model applied to this conversion. DEDUCTED deducts fees from the source amount. ON_TOP adds fees on top of the quoted source amount.

Available options:

FEE_MODEL_UNSPECIFIED,

INCLUSIVE,

DEDUCTED,

ON_TOP

Example:

"INCLUSIVE"

fees_total_currency

enum<string>

Currency that fees_total is expressed in.

Available options:

CONVERSION_CURRENCY_UNSPECIFIED,

USDC,

USD,

MXN,

INR,

KRW,

USDT,

GHS,

EUR,

JPY,

PHP,

IDR,

THB,

MYR,

SGD,

BRL,

HNL,

GBP,

COP,

GTQ,

KES,

BOB,

EGP,

JMD,

CLP,

ARS,

PEN,

PKR,

CRC,

DOP,

CAD,

ZAR,

AUD,

AED,

SAR,

ILS,

QAR,

JOD

Example:

"USDC"

quote_id

string

read-only

Quote referenced on submit.

failure_reason

string | null

read-only

Human-readable reason when the conversion failed, was canceled, or was returned. Omitted when unset.

refund_details

RefundDetails · object | null

Present only when status is RETURNED.

Show child attributes

identity_id

string

read-only

Unique identifier of the identity that owns the account.

Authentication

API Reference

Webhooks

Submit Conversion

Authorizations

Body

Response