API Info Mutasi Bank RAYA | Raya Developer Portal

Informasi API

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

Kendali Versi

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

Deskripsi Produk

API ini akan menampilkan riwayat transaksi akun Anda dengan jangka waktu maksimal satu bulan per respons untuk setiap permintaan dan riwayat data transaksi yang tersedia. Jika Anda memasukkan tanggal yang tidak ada transaksi, sistem akan memberikan data respons untuk transaksi pada tanggal terakhir dari bulan yang dimasukkan.

End Point

A. Info Mutasi Bank RAYA

Penjelasan Endpoint

Endpoint ini digunakan untuk mengecek riwayat transaksi debit dan kredit sesuai dengan nomor rekening dan jangka waktu yang diinginkan.

Informasi Umum

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