API Transfer Antar Rekening Bank RAYA

Informasi API

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

Endpoint Transfer Antar Rekening Inquiry

Penjelasan Endpoint

Layanan ini digunakan untuk inquiry informasi rekening Debit dan Kredit yang akan digunakan untuk melaksanakan instruksi Transfer.

Informasi Umum

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"
}

Endpoint Transfer Antar Rekening Payment

Penjelasan Endpoint

Endpoint ini digunakan untuk meminta transfer dana antar dua rekening Bank Raya. Terdapat limit total transaksi dan limit transaksi harian yang akan ditetapkan oleh Bank Raya.

Informasi Umum

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"
}