This is a utilitarian API that allows to fetch forex rate and charges for a RAKMoneyTransfer or Electronic Funds Transfer (SWIFT) transaction. When only forex rate is required pass the charges flag as "false".
Version 2.1.0
- Fxrate has been enhanced to allow clients to fetch rate and charges for BankTransfer type of transactions
Version 2.1.1
- purpose_desc field has been removed since it is not required.
Version 2.1.2
- Added a field to.other_account_currency which needs to be always passed when transaction_type is BankTransfer
| Attachment | Size |
|---|---|
 Postman collection | 5.14 KB |
Basepath
/v2
API Developer
production
development
https://sandboxapi.rakbank.ae/sb/api
Paths
/fx_rates/query
post /fx_rates/query
Retrieve fx rate values and transaction charges for a specific country code, transaction_type and transfer_type
clientId
X-IBM-Client-Id
(apiKey located in header)
oauth
oauth
(oauth2 application)
Token URL
https://sandboxapi.rakbank.ae/sb/api/v1/partner_auth/token
Scopes
utility_fxrate
To retrieve fxrate and transaction charges
MsgId
Required in header
string
Unique Id sent from client. Value should be a unique identifier of the request in UUID format.
{
"maxLength": 50
}fxrate_query_request
Required in body
object
Request details to fetch fxrate and charges
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
200
200 OK
422
Error Response
500
Internal Server Error
Example Request
curl --request POST \
--url https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query \
--header 'accept: application/json' \
--header 'authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/json' \
--header 'msgid: REPLACE_THIS_VALUE' \
--header 'x-ibm-client-id: REPLACE_THIS_KEY' \
--data '{"from_currency_code":"AED","to_currency_code":"INR","value":{"currency":"AED","amount":"2001"},"charges":true,"other_bank_country":"IN","transaction_type":"RAKMoney","transfer_type":"OutsideUAE","beneficiary_id":"2844311234281472","from":{"customer_id_type":"Account_ID","customer_id":"123243543654654"},"to":{"name":"Gordan","other_account_id":"963521478","other_account_currency":"AED","other_bank_name":"ICICI","other_branch_name":"PB-POTHUHERA.","other_branch_addr1":"15th Main,","other_branch_addr2":"Colombo","other_bank_country":"ZM","address":{"line_1":"cufadojalop","line_2":"irpawepzicah","line_3":"zetfo","city":"Dorgidiw","state":"TN","district":"onk","country":"GW"}},"purpose_code":"8","charges_type":"BEN"}'require 'uri'
require 'openssl'
require 'net/http'
url = URI("https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
request = Net::HTTP::Post.new(url)
request["x-ibm-client-id"] = 'REPLACE_THIS_KEY'
request["authorization"] = 'Bearer REPLACE_BEARER_TOKEN'
request["msgid"] = 'REPLACE_THIS_VALUE'
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"from_currency_code\":\"AED\",\"to_currency_code\":\"INR\",\"value\":{\"currency\":\"AED\",\"amount\":\"2001\"},\"charges\":true,\"other_bank_country\":\"IN\",\"transaction_type\":\"RAKMoney\",\"transfer_type\":\"OutsideUAE\",\"beneficiary_id\":\"2844311234281472\",\"from\":{\"customer_id_type\":\"Account_ID\",\"customer_id\":\"123243543654654\"},\"to\":{\"name\":\"Gordan\",\"other_account_id\":\"963521478\",\"other_account_currency\":\"AED\",\"other_bank_name\":\"ICICI\",\"other_branch_name\":\"PB-POTHUHERA.\",\"other_branch_addr1\":\"15th Main,\",\"other_branch_addr2\":\"Colombo\",\"other_bank_country\":\"ZM\",\"address\":{\"line_1\":\"cufadojalop\",\"line_2\":\"irpawepzicah\",\"line_3\":\"zetfo\",\"city\":\"Dorgidiw\",\"state\":\"TN\",\"district\":\"onk\",\"country\":\"GW\"}},\"purpose_code\":\"8\",\"charges_type\":\"BEN\"}"
response = http.request(request)
puts response.read_bodyimport http.client
conn = http.client.HTTPSConnection("sandboxapi.rakbank.ae")
payload = "{\"from_currency_code\":\"AED\",\"to_currency_code\":\"INR\",\"value\":{\"currency\":\"AED\",\"amount\":\"2001\"},\"charges\":true,\"other_bank_country\":\"IN\",\"transaction_type\":\"RAKMoney\",\"transfer_type\":\"OutsideUAE\",\"beneficiary_id\":\"2844311234281472\",\"from\":{\"customer_id_type\":\"Account_ID\",\"customer_id\":\"123243543654654\"},\"to\":{\"name\":\"Gordan\",\"other_account_id\":\"963521478\",\"other_account_currency\":\"AED\",\"other_bank_name\":\"ICICI\",\"other_branch_name\":\"PB-POTHUHERA.\",\"other_branch_addr1\":\"15th Main,\",\"other_branch_addr2\":\"Colombo\",\"other_bank_country\":\"ZM\",\"address\":{\"line_1\":\"cufadojalop\",\"line_2\":\"irpawepzicah\",\"line_3\":\"zetfo\",\"city\":\"Dorgidiw\",\"state\":\"TN\",\"district\":\"onk\",\"country\":\"GW\"}},\"purpose_code\":\"8\",\"charges_type\":\"BEN\"}"
headers = {
'x-ibm-client-id': "REPLACE_THIS_KEY",
'authorization': "Bearer REPLACE_BEARER_TOKEN",
'msgid': "REPLACE_THIS_VALUE",
'content-type': "application/json",
'accept': "application/json"
}
conn.request("POST", "/sb/api/v2/fx_rates/query", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\"from_currency_code\":\"AED\",\"to_currency_code\":\"INR\",\"value\":{\"currency\":\"AED\",\"amount\":\"2001\"},\"charges\":true,\"other_bank_country\":\"IN\",\"transaction_type\":\"RAKMoney\",\"transfer_type\":\"OutsideUAE\",\"beneficiary_id\":\"2844311234281472\",\"from\":{\"customer_id_type\":\"Account_ID\",\"customer_id\":\"123243543654654\"},\"to\":{\"name\":\"Gordan\",\"other_account_id\":\"963521478\",\"other_account_currency\":\"AED\",\"other_bank_name\":\"ICICI\",\"other_branch_name\":\"PB-POTHUHERA.\",\"other_branch_addr1\":\"15th Main,\",\"other_branch_addr2\":\"Colombo\",\"other_bank_country\":\"ZM\",\"address\":{\"line_1\":\"cufadojalop\",\"line_2\":\"irpawepzicah\",\"line_3\":\"zetfo\",\"city\":\"Dorgidiw\",\"state\":\"TN\",\"district\":\"onk\",\"country\":\"GW\"}},\"purpose_code\":\"8\",\"charges_type\":\"BEN\"}",
CURLOPT_HTTPHEADER => array(
"accept: application/json",
"authorization: Bearer REPLACE_BEARER_TOKEN",
"content-type: application/json",
"msgid: REPLACE_THIS_VALUE",
"x-ibm-client-id: REPLACE_THIS_KEY"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}// OkHttpClient from http://square.github.io/okhttp/
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"from_currency_code\":\"AED\",\"to_currency_code\":\"INR\",\"value\":{\"currency\":\"AED\",\"amount\":\"2001\"},\"charges\":true,\"other_bank_country\":\"IN\",\"transaction_type\":\"RAKMoney\",\"transfer_type\":\"OutsideUAE\",\"beneficiary_id\":\"2844311234281472\",\"from\":{\"customer_id_type\":\"Account_ID\",\"customer_id\":\"123243543654654\"},\"to\":{\"name\":\"Gordan\",\"other_account_id\":\"963521478\",\"other_account_currency\":\"AED\",\"other_bank_name\":\"ICICI\",\"other_branch_name\":\"PB-POTHUHERA.\",\"other_branch_addr1\":\"15th Main,\",\"other_branch_addr2\":\"Colombo\",\"other_bank_country\":\"ZM\",\"address\":{\"line_1\":\"cufadojalop\",\"line_2\":\"irpawepzicah\",\"line_3\":\"zetfo\",\"city\":\"Dorgidiw\",\"state\":\"TN\",\"district\":\"onk\",\"country\":\"GW\"}},\"purpose_code\":\"8\",\"charges_type\":\"BEN\"}");
Request request = new Request.Builder()
.url("https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query")
.post(body)
.addHeader("x-ibm-client-id", "REPLACE_THIS_KEY")
.addHeader("authorization", "Bearer REPLACE_BEARER_TOKEN")
.addHeader("msgid", "REPLACE_THIS_VALUE")
.addHeader("content-type", "application/json")
.addHeader("accept", "application/json")
.build();
Response response = client.newCall(request).execute();// Install request by running "npm install --save request"
var request = require("request");
var options = { method: 'POST',
url: 'https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query',
headers:
{ accept: 'application/json',
'content-type': 'application/json',
msgid: 'REPLACE_THIS_VALUE',
authorization: 'Bearer REPLACE_BEARER_TOKEN',
'x-ibm-client-id': 'REPLACE_THIS_KEY' },
body:
{ from_currency_code: 'AED',
to_currency_code: 'INR',
value: { currency: 'AED', amount: '2001' },
charges: true,
other_bank_country: 'IN',
transaction_type: 'RAKMoney',
transfer_type: 'OutsideUAE',
beneficiary_id: '2844311234281472',
from:
{ customer_id_type: 'Account_ID',
customer_id: '123243543654654' },
to:
{ name: 'Gordan',
other_account_id: '963521478',
other_account_currency: 'AED',
other_bank_name: 'ICICI',
other_branch_name: 'PB-POTHUHERA.',
other_branch_addr1: '15th Main,',
other_branch_addr2: 'Colombo',
other_bank_country: 'ZM',
address:
{ line_1: 'cufadojalop',
line_2: 'irpawepzicah',
line_3: 'zetfo',
city: 'Dorgidiw',
state: 'TN',
district: 'onk',
country: 'GW' } },
purpose_code: '8',
charges_type: 'BEN' },
json: true };
request(options, function (error, response, body) {
if (error) return console.error('Failed: %s', error.message);
console.log('Success: ', body);
});
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query"
payload := strings.NewReader("{\"from_currency_code\":\"AED\",\"to_currency_code\":\"INR\",\"value\":{\"currency\":\"AED\",\"amount\":\"2001\"},\"charges\":true,\"other_bank_country\":\"IN\",\"transaction_type\":\"RAKMoney\",\"transfer_type\":\"OutsideUAE\",\"beneficiary_id\":\"2844311234281472\",\"from\":{\"customer_id_type\":\"Account_ID\",\"customer_id\":\"123243543654654\"},\"to\":{\"name\":\"Gordan\",\"other_account_id\":\"963521478\",\"other_account_currency\":\"AED\",\"other_bank_name\":\"ICICI\",\"other_branch_name\":\"PB-POTHUHERA.\",\"other_branch_addr1\":\"15th Main,\",\"other_branch_addr2\":\"Colombo\",\"other_bank_country\":\"ZM\",\"address\":{\"line_1\":\"cufadojalop\",\"line_2\":\"irpawepzicah\",\"line_3\":\"zetfo\",\"city\":\"Dorgidiw\",\"state\":\"TN\",\"district\":\"onk\",\"country\":\"GW\"}},\"purpose_code\":\"8\",\"charges_type\":\"BEN\"}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-ibm-client-id", "REPLACE_THIS_KEY")
req.Header.Add("authorization", "Bearer REPLACE_BEARER_TOKEN")
req.Header.Add("msgid", "REPLACE_THIS_VALUE")
req.Header.Add("content-type", "application/json")
req.Header.Add("accept", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import Foundation
let headers = [
"x-ibm-client-id": "REPLACE_THIS_KEY",
"authorization": "Bearer REPLACE_BEARER_TOKEN",
"msgid": "REPLACE_THIS_VALUE",
"content-type": "application/json",
"accept": "application/json"
]
let parameters = [
"from_currency_code": "AED",
"to_currency_code": "INR",
"value": [
"currency": "AED",
"amount": "2001"
],
"charges": true,
"other_bank_country": "IN",
"transaction_type": "RAKMoney",
"transfer_type": "OutsideUAE",
"beneficiary_id": "2844311234281472",
"from": [
"customer_id_type": "Account_ID",
"customer_id": "123243543654654"
],
"to": [
"name": "Gordan",
"other_account_id": "963521478",
"other_account_currency": "AED",
"other_bank_name": "ICICI",
"other_branch_name": "PB-POTHUHERA.",
"other_branch_addr1": "15th Main,",
"other_branch_addr2": "Colombo",
"other_bank_country": "ZM",
"address": [
"line_1": "cufadojalop",
"line_2": "irpawepzicah",
"line_3": "zetfo",
"city": "Dorgidiw",
"state": "TN",
"district": "onk",
"country": "GW"
]
],
"purpose_code": "8",
"charges_type": "BEN"
]
let postData = NSJSONSerialization.dataWithJSONObject(parameters, options: nil, error: nil)
var request = NSMutableURLRequest(URL: NSURL(string: "https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query")!,
cachePolicy: .UseProtocolCachePolicy,
timeoutInterval: 10.0)
request.HTTPMethod = "POST"
request.allHTTPHeaderFields = headers
request.HTTPBody = postData
let session = NSURLSession.sharedSession()
let dataTask = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error)
} else {
let httpResponse = response as? NSHTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()Example Response
POST https://sandboxapi.rakbank.ae/sb/api/v2/fx_rates/query
{
"from_currency_code": "AED",
"to_currency_code": "INR",
"value": {
"currency": "AED",
"amount": "2001"
},
"date": "",
"fx_rates": [
{
"rate": "0.053539",
"rate_code": "TTS",
"currency": "INR",
"converted_amount": "112067.84"
}
],
"charges": {
"currency": "AED",
"amount": "50.00",
"tax": "15.00",
"discount": "wavcanrufe",
"total": "wunfebsirecker"
},
"total_credit_amount": "50000.00",
"total_debit_amount": "2020.00",
"per_transaction_limit": "40000",
"limit_exceeded_indicator": false
}Try this operation
Definitions
Error Response details
{
"properties": {
"status": {
"type": "string",
"description": "HTTP Status",
"example": "422"
},
"response_code": {
"type": "string",
"description": "API specific error code",
"example": "20006"
},
"property": {
"type": "string"
},
"response_message": {
"type": "string",
"description": "type of the error",
"example": "business exception"
},
"description": {
"type": "string",
"description": "detailed description of the error",
"example": "beneficiary_id not found"
}
},
"additionalProperties": false,
"required": [
"response_message",
"response_code",
"status"
]
}
Details of the transaction charges
{
"additionalProperties": false,
"properties": {
"currency": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"description": "Currency code of the charges.",
"example": "AED"
},
"amount": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Charge Amount.",
"example": "50.00"
},
"tax": {
"type": "string",
"minLength": 0,
"maxLength": 20,
"description": "Tax levied for the transaction.",
"example": "15.00"
},
"discount": {
"type": "string",
"minLength": 0,
"maxLength": 20,
"description": "Discount on the charges."
},
"total": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Total charges applied for the transaction."
}
},
"required": [
"currency",
"amount",
"total"
]
}
Details of the transaction rate
{
"properties": {
"rate": {
"type": "string",
"pattern": "^\\d{20}.\\d{10}$",
"description": "Exchange rate. Rate format: 1 unit of \"to_currency_code\" = \"rate\" units of AED",
"example": "0.053539"
},
"rate_code": {
"type": "string",
"minLength": 1,
"maxLength": 5,
"description": "Exchange rate code.",
"example": "TTS"
},
"currency": {
"type": "string",
"example": "INR",
"description": "Converted Amount currency."
},
"converted_amount": {
"description": "Converted Amount value. Converted Amount in \"from_currency_code\" when \"value.currency\" = \"to_currency_code\" OR Converted Amount in \"to_currency_code\" when \"value.currency\" = \"from_currency_code\".",
"type": "string",
"example": "112067.84"
}
},
"additionalProperties": false,
"required": [
"converted_amount",
"currency",
"rate"
]
}
This defines the details of the rate and charges that would be applicable for a remittance transaction.
{
"properties": {
"from_currency_code": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"example": "AED",
"description": "Currency code of the debit account."
},
"to_currency_code": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"example": "INR",
"description": "Currency code of the credit account."
},
"value": {
"$ref": "#/definitions/value"
},
"date": {
"type": "string",
"minLength": 1,
"example": "",
"description": "Current datetime.",
"format": "date-time"
},
"fx_rates": {
"type": "array",
"items": {
"$ref": "#/definitions/fx_rates"
}
},
"charges": {
"$ref": "#/definitions/charges"
},
"total_credit_amount": {
"type": "string",
"minLength": 0,
"maxLength": 20,
"description": "Total credit amount.",
"example": "50000.00"
},
"total_debit_amount": {
"type": "string",
"minLength": 0,
"maxLength": 20,
"description": "Total debit amount.",
"example": "2020.00"
},
"per_transaction_limit": {
"type": "string",
"minLength": 0,
"maxLength": 20,
"description": "Per transaction limit in 'to' currency. Provided when beneficiary_id is provided in the request.",
"example": "40000"
},
"limit_exceeded_indicator": {
"type": "boolean",
"description": "Returns \"true\" if requested amount exceeds the per transaction limit. Provided when beneficiary_id is provided in the request."
}
},
"additionalProperties": false,
"required": [
"from_currency_code",
"to_currency_code",
"value",
"total_credit_amount",
"fx_rates",
"date"
]
}
This contains the transaction amount details
{
"properties": {
"currency": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"description": "Currency",
"example": "AED"
},
"amount": {
"type": "string",
"pattern": "^((\\d{1}|\\d{2}|\\d{3}|\\d{4}|\\d{5}|\\d{6}|\\d{7}|\\d{8}|\\d{9}|\\d{10}|\\d{11}|\\d{12}|\\d{13}|\\d{14}|\\d{15}|\\d{16})?\\.?(\\d{1}|\\d{2}|\\d{3})?)$",
"minLength": 1,
"maxLength": 20,
"description": "Amount Value. Only Decimal(16,3) values allowed.",
"example": "2001"
}
},
"additionalProperties": false,
"required": [
"currency",
"amount"
]
}
This definition contains the parameters used to fetch the forex rate and charges for remittance transactions.
{
"properties": {
"from_currency_code": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"description": "Debit curency code.",
"example": "AED"
},
"to_currency_code": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"description": "Credit currency code.",
"example": "INR"
},
"value": {
"$ref": "#/definitions/value"
},
"charges": {
"type": "boolean",
"description": "Indicates whether to fetch the transaction charges. Possible values: true or false",
"example": true
},
"other_bank_country": {
"example": "IN",
"type": "string",
"minLength": 1,
"maxLength": 2,
"description": "ISO 2 character country code of the other bank. Mandatory in the request for transaction_type=RAKMoney. Not required for transaction_type=BankTranfer."
},
"transaction_type": {
"type": "string",
"enum": [
"RAKMoney",
"BankTransfer"
],
"description": "Type of the Transaction. Select 'RAKMoney' - in case of RAK Money Transfer and 'BankTranfer' in case of SWIFT or UAEFTS transfers.",
"example": "RAKMoney"
},
"transfer_type": {
"type": "string",
"enum": [
"OutsideUAE",
"RAKMoneyCashPayout"
],
"description": "Type of the beneficiary. Allowed values are 'OutsideUAE' - beneficiary account is outside UAE, 'RAKMoneyCashPayout' - RAKMoney Cash payout beneficiary. Mandatory in the request for transaction_type=RAKMoney. Not required for transaction_type=BankTranfer.",
"example": "OutsideUAE"
},
"beneficiary_id": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"description": "Id of the beneficiary to be passed when exact charges are required for RAKMoneyTransfer remittances i.e. when transaction_type=RAKMoney. Will be ignored if 'charges' is set to false. Not required for transaction_type=BankTranfer."
},
"from": {
"$ref": "#/definitions/from",
"description": "This will contain the details of the remitter. Mandatory in the request when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney."
},
"to": {
"$ref": "#/definitions/to",
"description": "This will contain the details of the beneficiary. Mandatory in the request when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney."
},
"purpose_code": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "Code for the Purpose of the remittance. Must be passed when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney.",
"example": "8"
},
"charges_type": {
"type": "string",
"enum": [
"BEN",
"SHA",
"OUR"
],
"description": "Charge Type selected by the customer. Valid options are BEN - All charges to Beneficiary, SHA - Share the charges, OUR - All charges to be charged to the customer. Mandatory in the request when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney.",
"example": "BEN"
}
},
"additionalProperties": false,
"required": [
"from_currency_code",
"to_currency_code",
"value",
"charges",
"transaction_type"
]
}
This will contain the details of the beneficiary. Mandatory in the request when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney.
{
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Name of the beneficiary.",
"example": "Gordan"
},
"other_account_id": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Account id of the beneficiary. Will hold IBAN when other_bank_country=AE.",
"example": "963521478"
},
"other_account_currency": {
"type": "string",
"minLength": 1,
"maxLength": 3,
"description": "Currency of the beneficiary account. Same as Remitting curreny.",
"example": "AED"
},
"other_bank_name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Bank Name of the beneficiary bank.",
"example": "ICICI"
},
"other_branch_name": {
"type": "string",
"maxLength": 75,
"description": "Branch Name of the other bank. Mandatory in the request when other_bank_country is not AE. Default value '001' to be sent in the request when other_bank_country=AE and other_account_currency is not AED. Not required when other_bank_country=AE and other_account_currency=AED.",
"example": "PB-POTHUHERA."
},
"other_branch_addr1": {
"type": "string",
"maxLength": 100,
"description": "Address of the beneficiary bank.",
"example": "15th Main,"
},
"other_branch_addr2": {
"type": "string",
"maxLength": 100,
"description": "City of the other bank. City of the beneficiary bank. Mandatory in the request when other_bank_country is not AE. Default value 'AE' to be sent in the request when other_bank_country=AE and other_account_currency is not AED. Not required when other_bank_country=AE and other_account_currency=AED.",
"example": "Colombo"
},
"other_bank_country": {
"type": "string",
"minLength": 1,
"maxLength": 2,
"description": "ISO 2 character country code of the beneficiary bank."
},
"address": {
"$ref": "#/definitions/address",
"description": "Address of residence or incorporation of the beneficiary."
}
},
"additionalProperties": false,
"required": [
"name",
"other_account_id",
"other_account_currency",
"other_bank_name",
"other_bank_country",
"address"
]
}
This will contain the details of the remitter. Mandatory in the request when charges are required for SWIFT/UAEFTS remittances i.e. when transaction_type=BankTranfer. Not required for transaction_type=RAKMoney.
{
"properties": {
"customer_id_type": {
"type": "string",
"enum": [
"Account_ID"
],
"description": "Type of the Customer id of the customer who initiates the transaction. Allowed values: Account_ID - RAKBank Account Id of the customer",
"example": "Account_ID"
},
"customer_id": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"example": "123243543654654",
"description": "Customer id of the customer, corresponding to the customer_id_type, who initiates the transaction."
}
},
"additionalProperties": false,
"required": [
"customer_id",
"customer_id_type"
]
}
{
"properties": {
"line_1": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Address line 1 of the beneficiary"
},
"line_2": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Address line 2 of the beneficiary"
},
"line_3": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Address line 3 of the beneficiary"
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "City of the beneficiary"
},
"state": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "State of the beneficiary"
},
"district": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "District of the beneficiary"
},
"country": {
"type": "string",
"minLength": 1,
"maxLength": 2,
"description": "Country of the residence or incorporation of the beneficiary. ISO 2 Character Country Codes."
}
},
"additionalProperties": false,
"required": [
"country"
]
}