Create Conversion

POST

api/v1/account/conversion

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

x-api-version

string

optional

Body Params application/json

buy_currency

string

required

conversion_date

null

required

reason

string

required

request_id

string

required

sell_amount

integer

required

sell_currency

string

required

term_agreement

boolean

required

Example

{
  "buy_currency": "USD",
  "conversion_date": null,
  "reason": "For settling a payment",
  "request_id": "{{$guid}}",
  "sell_amount": 200,
  "sell_currency": "SGD",
  "term_agreement": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-sandbox.z.incapi/v1/account/conversion' \
--header 'x-api-version;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "buy_currency": "USD",
  "conversion_date": null,
  "reason": "For settling a payment",
  "request_id": "{{$guid}}",
  "sell_amount": 200,
  "sell_currency": "SGD",
  "term_agreement": true
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{
    "awx_rate": 1.349251,
    "buy_amount": 148.23,
    "buy_currency": "USD",
    "client_rate": 1.349251,
    "conversion_date": "2024-07-25",
    "conversion_id": "8a683a9a-cb32-4896-8a8b-edcd9b443bc2",
    "created_at": "2024-07-25T10:08:42+0000",
    "currency_pair": "USDSGD",
    "dealt_currency": "SGD",
    "mid_rate": 1.34216,
    "rate_details": [
        {
            "buy_amount": 148.23,
            "level": "CLIENT",
            "rate": 1.349251,
            "sell_amount": 200
        }
    ],
    "reason": "For settling a payment",
    "request_id": "95d0279a-3ed8-4a81-9f84-541daebcbe14",
    "sell_amount": 200,
    "sell_currency": "SGD",
    "short_reference_id": "C240725-ZC00IPU",
    "status": "SETTLED",
    "last_updated_at": "2024-07-25T10:08:42+0000",
    "settlement_cutoff_time": "2024-07-25T10:08:42+0000"
}

Modified at 2024-07-27 18:41:37

Get Card Transactions

Get Quote