Create a Quote

POST/quotes

Create a new quote is used to get a quote for a transfer from one country to another.

Response

Created

idstring<uuid>

Transfer Identifier

external_idstring

Transfer Reference provided by API caller

mode"sending" | "receiving"

sending mode allow users to specify the sending_amount and get a quote for receiving_amount; receiving mode allows users to specify the receiving_amount and get a quote for sending_amount.

source_countrystring<iso-3166-1-alpha3>

Country code funds sent from (ISO-3166-1), e.g. USA

destination_countrystring<iso-3166-1-alpha3>

Country code funds sent to (ISO-3166-1), e.g. USA

destination_account_type"bank_account" | "digital_wallet" | "cash_pickup" | "card"

The Account Type to receive funds

sending_amountnumber<double>

Sending amount

sending_currencystring<iso-4217-ext>

Sending Currency which is defined by /currencies.

receiving_amountnumber<double>

Receiving amount

receiving_currencystring<iso-4217-ext>

Receiving Currency which is defined by /currencies.

exchange_ratenumber<double>

The exchange rate from sending currency to receiving currency, e.g. 1 BTC = 57151.5 USD.

feenumber<double>

This indicates the amount which will be debit from merchant’s balance with balance_id for this transfer.

fee_currencystring<iso-4217-ext>

Iso-4217 for fiat_money (i.e., local currency), non-iso-4217 listed here (https://en.wikipedia.org/wiki/ISO_4217) for cyptocurrency’

expires_atstring<date-time>

charge_type"OUR" | "SHA"

To specify which party bears the bank fee. OUR means that the initiator will pay the fee, which means an additional fee when you create the transfer. SHA means that both the initiator and the recipient will pay the fee. Some fees will be deducted from the amount sent by the intermediary banks

intermediary_bank_feenumber<double>

Indicates the intermediary bank charge. It will follow the sending currency.

conditionsobject

Conditions that a transfer must meet before it can be processed

Show conditions properties

document_typesobject

Show document_types properties

transfer_purposestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

const response = await fetch(`https://api.uat.triple-a.io/api/fiat-payout/v1/quotes`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify(null) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/quotes", headers={ "Authorization": "Bearer <token>" }, json=None, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.uat.triple-a.io/api/fiat-payout/v1/quotes"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, 'null'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/quotes", strings.NewReader(`null`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.uat.triple-a.io/api/fiat-payout/v1/quotes")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("null")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.uat.triple-a.io/api/fiat-payout/v1/quotes") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "null" response = http.request(request) puts response.body

{ "id": "00000000-0000-0000-0000-000000000000", "external_id": "string", "mode": "sending", "source_country": "USA", "destination_country": "CHN", "destination_account_type": "bank_account", "sending_amount": 0.01, "sending_currency": "BTC", "receiving_amount": 57.15, "receiving_currency": "USD", "exchange_rate": 57151.5, "fee": 57.15, "fee_currency": "USD", "expires_at": "2023-07-13T15:31:02.886Z", "charge_type": "SHA", "intermediary_bank_fee": 25, "conditions": { "document_types": { "transfer_purpose": "string" } } }