Getting Started

First, you must register on the Bank Raya Developer Portal. Click register in the upper right corner of the homepage and fill in your personal data, including First Name, Last Name, and Email. The name and email used on registration should be the representative of your company and will be used on the production request process. You are also required to state that you have agreed to the applicable Terms and Conditions.

Wait for the activation email to be sent to your inbox, then follow the link provided to activate your Bank Raya account.

After following the link provided, you will be asked to fill in your password.

Congratulations, you are one step closer to the development of Raya API.

You will receive a Consumer Key and a Consumer Secret to use the Bank Raya Sandbox, which allows you to create applications on the web developer portal.

Next, click "Add App". Fill in the app name and leave the Callback URL blank. In this example, we can choose inquiry-sandbox You can also modify and add other products according to your business needs. You can create a new app portal to get the appropriate key and secret to use.

A new app portal will appear in the My Apps menu. Click on the name of the application you create to see details regarding the application.

It is very important to keep your Consumer Key and Consumer Secret secure. The key and secret will be needed to access your sandbox environment.

Sharing your Credentials (key and secret) with unauthorized persons is prohibited!

This is the final step to start integrating Raya API into your application. All endpoints in Raya API are REST-based and use JSON format. We recommend  Postman as an app to test Raya API products.

Fill in client_id with your Consumer Key and then client_secret with your Consumer Secret

After importing and filling in your  key and secret, you can start making a request to Raya API. First, hit the Get Token request. Every endpoint will check this token to decide whether you are authorized or not.

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

• If you are using the provided Postman collection, all you need to do is open the Get Token endpoint and press 'Submit'. You will get detailed information regarding your Raya API account. Please note the token variable containing the token to be used in every API request. This is explained in more detail in the  Authentication section.

GET TOKEN EXAMPLE RESPONSE:

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

We also provide the Curl command if you are not comfortable using Postman. Replace  {{ client_id }} with your Consumer Key and {{ client_secret }} you’re your Consumer Secret. Please omit the {{ and }}.