BCA Unique Code

1. Create Unique Code

To start creating BCA Unique Code, you can use BCA Unique Code API with these details:

curl --location 'https://stgapi.onebrick.io/stg/v2/payments/gs/top-up/unique-code' \
--header 'publicAccessToken: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI4IiwiY29sb3VyIjoiI2MzMDdmYyIsInJvbGUiOlsiVVNFUiJdLCJuYW1lIjoiQXV0b21hdGlvbiBUZXN0ZXJmdm9qem5ka2Y0cTkzanY1bDcydWlheTZodWx3Y2MiLCJpc3MiOiJBdXRvbWF0aW9uIFRlc3RlcmZ2b2p6bmRrZjRxOTNqdjVsNzJ1aWF5Nmh1bHdjYyIsImV4cCI6MTcxNTg1MDQ5NSwiaWF0IjoxNzE1ODUwMTk1LCJqdGkiOiJmZTlhNzdjYy1kOWFkLTQ0YjAtODM3Yy04MTNjN2UzY2MzYTMiLCJ0cyI6MTcxNTg1MDE5NTMyNn0.qPQnSoLB4WNwf24uIfzfAijlfurJNBnp4dPkk768QK4' \
--header 'Content-Type: application/json' \
--data '{
    "receiveAmount": 11000
}'

Request :

host: brick-publisher host
method: post
url; /v2/payments/gs/top-up/unique-code
request-body:
{
    "receiveAmount": 11000
}
header: publicAccessToken (Bearer)

You will get the responses like below when successful:

{
    "status": 200,
    "data": {
        "message": "We have successfully retrieved the topup unique code",
        "transactionId": "UC_2828dffaf467490a8559d3f047c2b4ef",
        "bankShortCode": "BCA",
        "accountNo": "123",
        "displayName": "PT. Dompet Harapan Bangsa",
        "amount": 11291,
        "uniqueCode": 291,
        "amountUnique": 11291
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

2. Get Unique Code Status

To Get status of BCA Unique Code, you can use BCA Unique Code status API with these details:

curl --location 'https://stgapi.onebrick.io/stg/v2/payments/gs/top-up/unique-code?ref-id=UC_7593a91a95a54955b98a79a0968dbfff' \
--header 'publicAccessToken: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI4IiwiY29sb3VyIjoiI2MzMDdmYyIsInJvbGUiOlsiVVNFUiJdLCJuYW1lIjoiQXV0b21hdGlvbiBUZXN0ZXJmdm9qem5ka2Y0cTkzanY1bDcydWlheTZodWx3Y2MiLCJpc3MiOiJBdXRvbWF0aW9uIFRlc3RlcmZ2b2p6bmRrZjRxOTNqdjVsNzJ1aWF5Nmh1bHdjYyIsImV4cCI6MTcxNTg1MDIzNiwiaWF0IjoxNzE1ODQ5OTM2LCJqdGkiOiIxYjEwNGVhYi0wZDc5LTQyYjQtYTcxMS0zY2Q1MjJiYzk0ZTIiLCJ0cyI6MTcxNTg0OTkzNjUzNn0.aVTt3niEyEJnYB9a5i-BNWG1ckR_LzM2p5L6qXhdeJ4'

Request :

host: brick-publisher host
method: get
url; /v2/payments/gs/top-up/unique-code
query-param: ref-id
header: publicAccessToken (Bearer)

You will get the responses like below when successful:

{
    "status": 200,
    "data": {
        "transactionId": "UC_7593a91a95a54955b98a79a0968dbfff",
        "amount": 11000,
        "payAmount": 11709,
        "uniqueCode": 709,
        "createdAt": "2024-04-22T11:25:33.000+07:00",
        "expiredAt": "2024-04-22T14:25:32.000+07:00",
        "status": "expired"
    },
    "metaData": {
        "source": "API",
        "entity": "Payment"
    },
    "error": null
}

3. What to do after transaction created

After the transaction is created, the first step is to select a financial platform or service that supports unique code transactions. This could be a banking app.
Initiate the transaction by logging in to your account on the chosen platform or service and locating the option for unique code transactions. Look for a section or feature specifically for making transfers using unique codes. This might be under a menu like "Send Money," "Transfer Funds," or "Make a Payment."
When about to make the transfer, it is IMPORTANT to ensure you input the last three digits of the unique code correctly. For example, if the amount is Rp 50.123, make sure you transfer Rp 50.123, not Rp 50.000.
Double-check all details before completing the transaction.

📘
Note: The maximum transaction limit is 499,999,000, and transactions with an invalid time range should be between 3 AM and 7:30 PM. For unique code generation, the code will expire in 180 minutes.