Bank Raya Internal Transfer API | Raya Developer Portal

API Information

Title	API Transfer Internal Bank RAYA
Version	v1
URL Sandbox	https://api.sandbox.bankraya.co.id/intrabank/snap/v1.0
URL Production

Internal Transfer Inquiry Endpoint

Endpoint Explanation

This service is used to make inquiries for Debit and Credit account information that will be used to carry out Transfer instructions.

General Information

HTTP Method	POST
Path	/intrabank/snap/v1.0/account-inquiry-internal
Tipe Format	JSON
Authentication	Token & Signature

Header Structure

Key	Mandatory	Type	Description
X-SIGNATURE	M	String	HMAC_SHA512
X-TIMESTAMP	M	Datetime	Format Timestamp ISO8601
X-PARTNER-ID	M	Alphanumeric	Partner ID for integration. Using the same value as the client_id parameter used in Token endpoint
X-EXTERNAL-ID	M	Numeric	Unique numeric for API request
CHANNEL-ID	M	Alphanumeric	Channel used by Partner, Value provided by Bank Raya
Authorization	M	String	Bearer {Token}

Request Structure

Field	Mandatory	Type	Description	Example
beneficiaryAccountNo	M	String(15, 15)	Account Number Destination of the customer	001001000060300
additionalInfo	O	Object
>deviceId	O	Alphanumeric	To identify valid devices of customer or IMEI	001001000059309
>channel	M	Alphanumeric	Channel filled by Partner	MobileApp

Request & Response Payload Sample

Request:

{"beneficiaryAccountNo":"001001000060300","additionalInfo":{"deviceId":"","channel":""}}

Normal Response:

{
    "responseCode": "2001500",
    "responseMessage": "Successful",
    "referenceNo": "202212011994",
    "beneficiaryAccountNo": "001001000060300",
    "beneficiaryAccountName": "MONIKA SARI FARDANI",
    "beneficiaryAccountStatus": "Rekening Aktif",
    "beneficiaryAccountType": "S",
    "currency": "IDR",
    "additionalInfo": {
        "deviceId": "",
        "channel": ""
    }
}

Error Response:

{
    "responseCode": "4011500",
    "responseMessage": "Unauthorized Signature"
}
{
    "responseCode": "4001101",
    "responseMessage": "Invalid Format Field X-EXTERNAL-ID"
}

{
    "responseCode": "4011500",
    "responseMessage": "Unauthorized Client"
}

{
    "responseCode": "4091500",
    "responseMessage": "Conflict"
}

{
    "responseCode": "4001501",
    "responseMessage": "Invalid Format Field beneficiaryAccountNo"
}

{
    "responseCode": "4001502",
    "responseMessage": "Invalid Mandatory Field beneficiaryAccountNo"
}

{
    "responseCode": "4001501",
    "responseMessage": "Invalid Field Format deviceId"
}

{
    "responseCode": "5001701",
    "responseMessage": "Internal Server Error"
}

Internal Transfer Payment Endpoint

Endpoint Explanation

This endpoint is used to request funds transfer between two Bank Raya accounts. There is a total transaction limit and a daily transaction limit that have been set by Bank Raya.

General Information

HTTP Method	POST
Path	/intrabank/snap/v1.0/transfer-intrabank
Tipe Format	JSON
Authentication	Token & Signature

Header Structure

Key	Mandatory	Type	Description
X-SIGNATURE	M	String	HMAC_SHA512
X-TIMESTAMP	M	Datetime	Format Timestamp ISO8601
X-PARTNER-ID	M	Alphanumeric	Partner ID for integration. Using the same value as the client_id parameter used in Token endpoint
X-EXTERNAL-ID	M	Numeric	Unique numeric for API request
CHANNEL-ID	M	Alphanumeric	Channel used by Partner, Value provided by Bank Raya
Authorization	M	String	Bearer {Token}

Request Structure

Field	Mandatory	Type	Description	Example
partnerReferenceNo	M	Alphanumeric	Identification of transactions in the customer service system	202301251759
amount	M	Object
>value	M	Decimal	Net amount of the transaction	10000,00
>currency	M	Alphanumeric	Currency	IDR
beneficiaryAccountNo	M	Numeric	Beneficiary Account	001001000060300
customerReference	M	Alphanumeric	Reference Number / Referral Number / Transaction ID	202301251759
remark	M	Alphanumeric	Transaction Remark	Test Trx
sourceAccountNo	M	Numeric	Source Account Number	001001000060300
transactionDate	M	Datetime	transaction date : ISO 8601	2019-07-03T12:08:56-07:00
additionalInfo	O	Object
>deviceId	O	Alphanumeric	To identify valid devices of customer or IMEI
>channel	M	Alphanumeric	Channel filled by Partner

Request & Response Payload Sample

Request:

{"partnerReferenceNo":"2022111800100","amount":{"value":"1000.00","currency":"IDR"},"beneficiaryAccountNo":"001001000060300","customerReference":"202212011994","remark":"test trx","sourceAccountNo":"001001000002311","transactionDate":"2019-07-03T12:08:56-07:00","additionalInfo":{"deviceId":"","channel":""}}

Normal Response:

={
    "responseCode": "2001700",
    "responseMessage": "Request has been processed successfully",
    "referenceNo": "202212011996",
    "partnerReferenceNo": "2022111800100",
    "amount": {
        "value": "1000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "001001000060300",
    "customerReference": "202212011994",
    "sourceAccount": "001001000002311",
    "transactionDate": "2022-12-01T09:41:02+07:00",
    "additionalInfo": {
        "deviceId": "",
        "channel": ""
    }
}

Error Response:

{
    "responseCode": "4011700",
    "responseMessage": "Unauthorized Signature"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Format Field X-EXTERNAL-ID"
}

{
    "responseCode": "4011700",
    "responseMessage": "Unauthorized Client"
}

{
    "responseCode": "4091700",
    "responseMessage": "Conflict"
}

{
    "responseCode": "4091701",
    "responseMessage": "Duplicate partnerReferenceNo"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Format Field partnerReferenceNo"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field partnerReferenceNo"
}

{
    "responseCode": "4031702",
    "responseMessage": "Exceeds Transaction Amount Limit"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format amount"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field amount value"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format currency"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field currency"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format beneficiaryAccountNo"
}

{
    "responseCode": "4031715",
    "responseMessage": "Transaction Not Permitted. Invalid Request"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Format Field beneficiaryAccountNo"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field beneficiaryAccountNo"
}

{
    "responseCode": "4031715",
    "responseMessage": "Transaction Not Permitted. Customer Reference Not Found"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Format Field customerReference"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field customerReference"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format remark"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field remark"
}

{
    "responseCode": "4031715",
    "responseMessage": "Transaction Not Permitted. Don`t Have Access At This Account"
}

{
    "responseCode": "4031714",
    "responseMessage": "Insufficient Funds"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Format Field sourceAccountNo"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field sourceAccountNo"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format transactionDate"
}

{
    "responseCode": "4001702",
    "responseMessage": "Invalid Mandatory Field remark"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format deviceId"
}

{
    "responseCode": "4001701",
    "responseMessage": "Invalid Field Format channel"
}

{
    "responseCode": "5001101",
    "responseMessage": "Internal Server Error"
}