Get Exchanges Rate

GET 
/v2/international-disbursement/exchange-rates

An endpoint to get the exchange rate and other details of the destination country corridors such as minimum and maximum transfer amount, cut-off time, estimated arrival time, and the transfer fee.

Request

Query Parameters

country_iso_code string

Country code using ISO 3166 (Alpha-3). You can choose multiple countries separate by comma. See supported Country ISO Codes.

transaction_type stringrequired

Possible values: [C2C, C2B, B2B, B2C]

Transaction type information. Possible values are

Responses

200

Sample expected response

application/json; charset=UTF-8

Schema

Schema

• Array [

currency_code string
country_code string
country_name string
country_iso_code string
flip_exchange_rate integer
flip_transfer_fee integer
minimum_amount integer
maximum_amount integer
payment_speed string

arrival_message

object

id string

en string
notes string
transaction_type string
flip_cutoff_time string
flip_arrival_time string
is_active boolean

• ]

Example (from schema)

[
  {
    "currency_code": "GBP",
    "country_code": "GBR",
    "country_name": "United Kingdom",
    "country_iso_code": "GBR",
    "flip_exchange_rate": 19000.55,
    "flip_transfer_fee": 80000,
    "minimum_amount": 1.5,
    "maximum_amount": 3000.5,
    "payment_speed": "Same Day",
    "arrival_message": {
      "id": "Jika dana sudah kami terima sebelum hari Senin pukul 08:00 WIB, dana akan sampai di penerima hari Selasa, 07 Desember 2021",
      "en": "If Flip receive your fund before Monday at 08:00 GMT+7, the fund will be arrived to the beneficiary on Tuesday, 07 December 2021"
    },
    "notes": null,
    "transaction_type": "C2C",
    "flip_cutoff_time": "2021-12-06 01:00:00+700",
    "flip_arrival_time": "021-12-07 12:00:00+700",
    "is_active": true
  }
]

Array of Exchange Rates

[
  {
    "currency_code": "GBP",
    "country_code": "GBR",
    "country_name": "United Kingdom",
    "country_iso_code": "GBR",
    "flip_exchange_rate": 19000.55,
    "flip_transfer_fee": 80000,
    "minimum_amount": 1.5,
    "maximum_amount": 3000.5,
    "payment_speed": "Same Day",
    "arrival_message": null,
    "notes": null,
    "transaction_type": "C2C",
    "flip_cutoff_time": "2021-12-06 01:00:00+700",
    "flip_arrival_time": "2021-12-07 12:00:00+700",
    "is_active": true
  },
  {
    "currency_code": "AUD",
    "country_code": "AUS",
    "country_name": "Australia",
    "country_iso_code": "AUS",
    "flip_exchange_rate": 10588.78,
    "flip_transfer_fee": 80000,
    "minimum_amount": 1,
    "maximum_amount": 200000,
    "payment_speed": "+1 day",
    "arrival_message": {
      "id": "Jika dana sudah kami terima sebelum hari Senin pukul 08:00 WIB, dana akan sampai di penerima hari Selasa, 07 Desember 2021",
      "en": "If Flip receive your fund before Monday at 08:00 GMT+7, the fund will be arrived to the beneficiary on Tuesday, 07 December 2021"
    },
    "notes": null,
    "transaction_type": "C2C",
    "flip_cutoff_time": "2021-12-06 01:00:00+700",
    "flip_arrival_time": "2021-12-07 12:00:00+700",
    "is_active": true
  }
]

Exchange Rate Specific

{
  "currency_code": "GBP",
  "country_code": "GBR",
  "country_name": "United Kingdom",
  "country_iso_code": "GBR",
  "flip_exchange_rate": 19000.55,
  "flip_transfer_fee": 80000,
  "minimum_amount": 1.5,
  "maximum_amount": 3000.5,
  "payment_speed": "Same Day",
  "arrival_message": null,
  "notes": null,
  "transaction_type": "C2C",
  "flip_cutoff_time": "2021-12-06 01:00:00+700",
  "flip_arrival_time": "2021-12-07 12:00:00+700",
  "is_active": true
}

401

Sample response when Your Flip api secret key value for Authorization is missing or invalid

application/json; charset=UTF-8

Schema

Schema

name string
message string
status integer

Example (from schema)

{
  "name": "Unauthorized",
  "message": "Your request was made with invalid credentials.",
  "status": 401
}

422

Sample error response when transaction_type is invalid

application/json; charset=UTF-8

Schema

Schema

code string

errors

object[]

Array [

attribute string

code integer

message string

]

Example (from schema)

{
  "code": "VALIDATION_ERROR",
  "errors": [
    {
      "attribute": "transaction_type",
      "code": 1069,
      "message": "Param transaction_type is invalid"
    }
  ]
}

Loading...