Mulai Sekarang

Pertama-tama, Anda harus mendaftarkan diri ke website Bank Raya. Klik register di pojok kanan atas homepage dan lengkapi data diri mulai dari Nama Depan, Nama Belakang, Alamat Email serta mewajibkan Anda menyatakan bahwa Anda telah menyetujui Syarat dan Ketentuan yang berlaku.

Tunggu email aktivasi terkirim ke inbox Anda, kemudian ikuti tautan yang tersedia untuk melakukan aktivasi akun Bank Raya Anda.

Setelah mengikuti tautan yang tersedia, anda akan diminta untuk mengisi kata sandi. 

Selamat, Anda telah berhasil selangkah lebih dekat dengan pengembangan Raya API.

Anda akan mendapatkan Consumer Key dan Consumer Secret untuk menggunakan Sandbox Bank Raya yang memungkinkan Anda membuat aplikasi pada web developer portal. 

Kemudian klik "Add App". Isi nama aplikasi dan biarkan Callback URL kosong. Pada contoh ini, kita bisa memilih inquiry-sandbox. Anda juga dapat mengubah dan menambahkan produk lain sesuai dengan kebutuhan bisnis Anda. Anda dapat membuat portal app baru untuk mendapatkan key dan secret yang akan digunakan.

Setelah itu, akan ada portal app baru yang terbentuk di menu Aplikasi Saya. Klik nama aplikasi yang Anda buat untuk melihat detil terkait aplikasi.

Penting untuk selalu mengingat Consumer Key dan Consumer Secret.  Karena key dan secret akan dibutuhkan untuk mengakses Sandbox Environment Anda.

Dilarang membagikan Kredensial Anda (key dan secret) kepada orang yang tidak berhak!

Langkah terakhir untuk memulai integrasi Raya API dengan aplikasi Anda. Semua endpoint di Raya API menggunakan REST-based dan format JSON. Kami merekomendasikan penggunaan Postman sebagai salah satu aplikasi untuk mencoba produk dari Raya API. 

Sebelum Anda memulai, mohon import file Postman collection & environment. ke Postman Anda

Anda bisa mengubah client_id dengan Consumer Key kemudian client_secret dengan Consumer Secret Anda.

Setelah mengimpor dan mengisikan key dan secret, Anda dapat memulai membuat request ke Raya API. Pertama-tama, request Get Token. Setiap endpoint Raya API akan mengecek token untuk menentukan Anda memiliki hak akses atau tidak.

curl --location --request POST 'https://api.sandbox.bankraya.co.id/oauth/accesstoken?grant_type=client_credentials' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id={{ client_id }}
' \
--data-urlencode 'client_secret={{ client_secret }}'

Jika menggunakan collection Postman yang sudah disediakan, yang perlu Anda lakukan hanyalah buka endpoint Get Token dan tekan “Kirim”. Anda akan mendapatkan informasi detail terkait akun Raya API Anda. Perhatikan pada variabel token yang berisi token untuk digunakan dalam setiap API request. Hal ini akan dijelaskan lebih detail di bagian Autentikasi.

DAPATKAN CONTOH RESPON TOKEN:

{
    "refresh_token_expires_in": "0",
    "api_product_list": "[briagro-api-transfer-external-sandbox,  briagro-api-inquiry-sandbox, briagro-api-statement-sandbox, briagro-api-transfer-internal-sandbox]",
    "api_product_list_json": [
        "briagro-api-transfer-external-sandbox",
        " briagro-api-inquiry-sandbox",
        "briagro-api-statement-sandbox",
        "briagro-api-transfer-internal-sandbox"
    ],
    "organization_name": "briagro-apigee-c-apigateway",
    "developer.email": "mpratama@bankraya.co.id",
    "token_type": "BearerToken",
    "issued_at": "1641294379797",
    "client_id": "1RM8p5wLstjmEZGcfnAUsG1D9kShCcEfQpFFPyErGygxAbif\n",
    "access_token": "2BX5gf8zEWbRDMBWCiaP96vFavAL",
    "application_name": "9385934d-f948-47f2-ac29-3a0d03caeb54",
    "scope": "",
    "expires_in": "7199",
    "refresh_count": "0",
    "status": "approved"
}

Kami juga menyediakan perintah Curl sebagai alternatif seandainya Anda tidak nyaman dengan Postman. Ganti {{ client_id }} dengan Consumer Key dan {{ client_secret }} dengan Consumer Secret. Abaikan tanda {{ dan }}.

curl --location --request POST 'https://api.sandbox.bankraya.co.id/v1/inquiry/single' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data-raw '{
    "accountNumber": "001001000211309",
    "deviceInfo": ""
}'

Anda dapat menggunakan Account Information setelah mendapatkan respon sukses dari Get Token. Masukkan token yang anda dapatkan ke Header Authorization. Jika menggunakan Postman collection, proses akan selesai secara otomatis karena kami menambahkan beberapa script untuk mengotomasi proses tersebut. Tapi, jika anda menggunakan Curl, Anda dapat copy dan paste secara manual pada token. Kami menyediakan potongan perintah Curl di sebelah teks ini. Ganti {{TOKEN}} dengan token yang Anda dapatkan dari Get Token request yang Anda buat sebelumnya. Ganti {{TIMESTAMP}} Anda dengan format waktu dalam bentuk ISO8601 . Ganti {{SIGNATURE}} dengan tanda tangan yang dibuat berdasarkan algoritma Signature yang sudah dijelaskan sebelumnya. Jangan lupa menghilangkan tanda{{ dan }}.

Anda akan mendapatkan respons sukses jika anda memasukkan  token yang valid. Untuk mempermudah implementasi, cukup gunakan Postman collection & environment yang sudah kita sediakan sebelumnya.