Bank Raya Account Statement API | Raya Developer Portal

API Information

Title	API Info Mutasi Bank Raya
Version	SNAP v1
URL Sandbox	https://api.sandbox.bankraya.co.id/snap/v1.0/bank-statement
URL Production

Version Control

API Version	Date	Link to document	Description
v1	5 Maret 2021		Baseline version.
SNAP v1	25 Januari 2023	this page	SNAP BI specs

Description Product

This API will display your account transaction history with a maximum period of one month for each request.

End Point

A. Bank Raya Account Statement

Endpoint Explanation

This endpoint is used to check the history of debit and credit transactions based on the account number and the desired period.

General Information

HTTP Method	POST
Path	/snap/v1.0/bank-statement
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

Key	Mandatory	Type	Description	Example
accountNo	M	String(15)	Account Number of the customer	001001000060300
fromDateTime	M	Datetime	Start date/time of bank statement (YYYY-MM-DD)	2016-12-17
toDateTime	M	Datetime	End date/time of bank statement (YYYY-MM-DD)	2016-12-17

Request & Response Payload Sample

Request:

{"accountNo":"001001000060300","fromDateTime":"2020-08-18","toDateTime":"2020-08-20"}

Normal Response:

{
    "responseCode": "2001400",
    "responseDescription": "Successful",
    "totalCreditEntries": {
        "numberOfEntries": "8",
        "amount": {
            "value": "5784701",
            "currency": "IDR"
        }
    },
    "totalDebitEntries": {
        "numberOfEntries": "139",
        "amount": {
            "value": "402710781",
            "currency": "IDR"
        }
    },
    "detailData": [
        {
            "detailBalance": {
                "startAmount": [
                    {
                        "amount": {
                            "value": "13182109581.44",
                            "currency": "IDR"
                        }
                    }
                ],
                "endAmount": [
                    {
                        "amount": {
                            "value": "12785190000.48",
                            "currency": "IDR"
                        }
                    }
                ]
            },
            "amount": {
                "value": "1000.00",
                "currency": "IDR"
            },
            "transactionDate": "2020-08-20 21:59:33",
            "remark": "test trx",
            "transactionId": "001089120082090053600",
            "type": "Debit"
        }
    ]
}

Error Response:

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

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

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

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

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

{
    "responseCode": "4001402",
    "responseMessage": "Invalid Mandatory Field accountNo"
}

{
    "responseCode": "4001401",
    "responseMessage": "Invalid Field Format accountNo"
}

{
    "responseCode": "4041401",
    "responseMessage": "Transaction Not Found"
}

{
    "responseCode": "4001402",
    "responseMessage": "Invalid Mandatory Field fromDateTime"
}

{
    "responseCode": "4001402",
    "responseMessage": "Invalid Mandatory Field toDateTime"
}

{
    "responseCode": "4001401",
    "responseMessage": "Invalid Field Format fromDateTime"
}

{
    "responseCode": "4031415",
    "responseMessage": "Transaction Not Permitted. fromDateTime should be lower than toDateTime"
}

{
    "responseCode": "4001401",
    "responseMessage": "Invalid Field Format toDateTime"
}

{
    "responseCode": "4031415",
    "responseMessage": "Transaction Not Permitted. Maximum Statement Should Be 30 Days!"
}

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