Foreign Exchange-2

Create API

Foreign Exchange

API Information

Title Fund Transfer Internal

Version

v1

URL Sandbox

https://sandbox.partner.api.bri.co.id/v1/valas

URL Production

https://partner.api.bri.co.id/v1/valas

Version Control

Doc Version API Version Date Link to document Description

v1

v1

1 February 2019

Open Docs

Initial version

Product Description

Foreign Exchange is needed for transactions in the global market and it has official rates recorded in the central bank. This API will help you to monitor real-time foreign exchange rates and can make forex transactions directly from your business dashboard.

Currency Rate

Endpoint Description

This endpoint is used to validate whether the customer uses a valid BRIZZI card number or not when reloading.

                    curl -X GET 'https://sandbox.partner.api.bri.co.id/v1/valas/getrate/USD/IDR' \
                    -H 'Authorization: Bearer {{TOKEN}}' \
                    -H 'BRI-Signature: {{SIGNATURE}}' \
                    -H 'BRI-Timestamp: {{TIMESTAMP}}'

Example of Response

            {
                "status": true,
                "responseDescription": "Success",
                "responseCode": "001",
                "data": {
                    "dealt_currency": "USD",
                    "counter_currency": "IDR",
                    "TT_buy": "14315.0000",
                    "TT_sell": "14465.0000",
                    "last_update": "5/16/2019 11:31:20 AM"
                }
            }

HTTP Request

GET https://sandbox.partner.api.bri.co.id/v1/valas/getrate/{{DEALT_CURRENCY}}/{{COUNTER_CURRENCY}}

URL Parameters

Parameter Type Mandatory Description

dealt_currency

String

Yes

ISO 4217 currency code (eg. USD, EUR, GBP)

counter_currency

String

Yes

ISO 4217 currency code (IDR)

Forex Transaction

Endpoint Description

This endpoint is used for submitting forex transactions. This endpoint will reply with deal_number which needs to be taken to the BRI branch to make a transaction.

            curl -X POST 'https://sandbox.partner.api.bri.co.id/v1/valas/insert' \
            -H 'Authorization: Bearer {{TOKEN}}' \
            -H 'BRI-Signature: {{SIGNATURE}}' \
            -H 'BRI-Timestamp: {{TIMESTAMP}}' \
            -H 'Content-Type: application/json' \
            -d '{
            "counter_currency":"IDR",
            "dealt_currency":"USD",
            "dealt_amount":"4",
            "npwp":"111",
            "deal_type":"sell"
        }'

Example of Response

            {
              "status": true,
              "responseCode": "001",
              "responseDescription": "Transaction Successful",
              "data": {
                "deal_number": "A0908444",
                "value_date": "9/20/2018",
                "deal_date": "9/20/2018",
                "rate": "13365.0000",
                "dealt_amount": "4",
                "dealt_currency": "USD",
                "counter_amount": "53460.0000",
                "expired_transaction": "2018-09-20T16:00:00"
              }
            }

HTTP Request

POST https://sandbox.partner.api.bri.co.id/v1/transfer

Request Header

Key Value Mandatory

Content-Type

application/json

Yes

Request Body

Field Data Type Mandatory Description

counter_currency

string

Yes

-

dealt_currency

string

Yes

-

dealt_amount

string

Yes

-

npwp

string

Yes

-

deal_type

string

Yes

buy or sell