Mulai Sekarang

Pertama-tama, Anda harus mendaftarkan diri ke website Bank Raya Developer Portal. Klik register di pojok kanan atas homepage dan lengkapi data diri mulai dari Nama Depan, Nama Belakang, Alamat Email. Nama dan email yang anda gunakan saat register merupakan perwakilan perusahaan anda dan harus sama dengan nama dan email yang akan digunakan untuk pengajuan production. Anda juga diwajibkan untuk 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. 

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

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": "[email protected]",
    "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 }}.