Create a new Conversion Quotation

Create a new Conversion Quotation.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Create Conversion with Quotation Model.

source_currency

string | null

required

Three-letter ISO 4217 currency code

destination_currency

string | null

required

Three-letter ISO 4217 currency code

source_amount

number <double> | null

optional

Amount in source currency
(You should input either source_amount or destination_amount only, never input both at the same time)

destination_amount

number <double> | null

optional

Amount in destination currency
(You should input either source_amount or destination_amount only, never input both at the same time)

Example

Responses

🟢200OK

application/json

Success.

Body

Quotation information return in Response.

string <uuid>

optional

Quotation unique identifier

Example:

6d4545f5-2e53-4793-9f12-e57349d89490

payment_channel

enum<string>

optional

Payment channel

bank

ewallet

cash
We support 3 payment channels depending on destination country. Please refer to the respective payment channel Appendix for details information.

Allowed values:

bankcashewallet

source_country

string

optional

Source Country

Example:

source_currency

string

optional

Source (send) three-letter ISO 4217 currency code

Example:

SGD

source_amount

number <double>

optional

Amount in source currency

Example:

777

min_source_amount

number <double>

optional

Minimum source amount to send for remittance transaction

Example:

100

destination_country

string

optional

Destination country

Example:

CN / US / JP / ID

destination_currency

string

optional

Target (receive) three-letter ISO 4217 currency code

Example:

MOP

destination_amount

number <double>

optional

Amount in destination currency

Example:

712.79

rate

number <float>

optional

Exchange mid-rate

Example:

1.03319

ts_rate

number <float>

optional

Transwap rate with commissions

Example:

1.03319

ts_inverse_rate

number <float>

optional

Transwap inverse rate = 1 / ts_rate

fee

number <float>

optional

Conversion fee imposed by Transwap

Example:

87.11

transaction_fee

number <float>

optional

Transaction fee imposed by Transwap partners (Bank/Non-Bank)

Example:

87.11

valid_until

string <date-time>

optional

Validation of Quotation

Example:

2020-12-02T11:40:56.7395777+00:00

created_timestamp

string <date-time>

optional

Exchange rate creation date time in ISO8601 format (e.g 2018-03-22T16:08:02+00:00)

Example:

2020-12-01T11:40:56.7395714+00:00

last_modified_timestamp

string <date>

optional

Last modified date time in ISO8601 format (e.g. 2018-03-22T16:08:02+00:00)

Example

{
  "id": "f3a50e32-90bd-4251-9b82-c63f546eef24",
  "source_currency": "HKD",
  "destination_currency": "SGD",
  "source_amount": 5615.5247,
  "destination_amount": 1000,
  "rate": 0.18,
  "fee": 60,
  "valid_until": "2020-06-08T09:14:50.4272597+00:00",
  "created_timestamp": "2020-06-07T09:14:50.4272361+00:00",
  "last_modified_timestamp": null
}

🟠400Bad Request

🟠401Unauthorized

🟠429429

🔴500Server Error

Create a new Conversion Quotation

Request

Request samples

Responses