Inquiry - Islamic Payment Gateway

Request

Header Params

Authorization

string | null

deprecated

Bearer BasicAuthenticationToken if using Oauth2 Authentication

Signature

string

required

request body or query string hash value using HMAC method. algorithm=sha256, key = API_KEY

Accept

string

required

Accept application/json

Example:

application/json

Body Params application/json

channel

string

required

Channel where the request came

Example:

bankname

prefix

string

required

6 digit BCN

>= 6 characters

virtual_account

string

Bill Unique identification number

required

10 digits unique virtual account

>= 10 characters<= 10 characters

reference_id

string

Channel Transaction Reference ID

required

Request reference id

>= 5 characters

Example:

123456789

bill_mode

string

required

Choice of whether the invoice will be processed in single or multi mode

Default:

single

terminal

string

required

Source of channel transaction

Examples:

atminternet_bankingmobile_bankingtelleredcinterbanktransfervabizchannelposbifastother

Example

{
    "virtual_account": "1234567890",
    "channel": "bank_name",
    "prefix": "857499",
    "reference_id": "852963741",
    "bill_mode": "single",
    "terminal": "atm"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/inquiry' \
--header 'Authorization;' \
--header 'Signature;' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "virtual_account": "1234567890",
    "channel": "bank_name",
    "prefix": "857499",
    "reference_id": "852963741",
    "bill_mode": "single",
    "terminal": "atm"
}'

Responses

🟢200OK

application/json

Body

rc

enum<string>

read-onlyrequired

Allowed value:

SUCCESS

message

string

required

timestamp

string

required

data

object (Bill Model)

required

Information about bill

Example:

{"hash":"string","va_number":"8575991234567890","invoice_number":"string","type":"open","name":"SPP Januari 2022","customer_name":"string","customer_email":"string","customer_phone":"string","customer_address":"string","total_amount":0,"billed_amount":0,"paid_amount":0,"status":"paid","ext_description":"string","description":"string","valid_until":"2022-04-05T13:32:08+07:00","created_at":"2022-04-05T13:32:08+07:00","components":[{"id":"string","name":"string","qty":1,"price":"string","total":"string"}]}

hash

string

Bill Identification ID

required

Your Bill UNIQUE identification id

Example:

af7c1fe6-d669-414e-b066-e9733f0de7a8

va_number

string

required

16 digit Full Qualified Virtual Number

Example:

8575991234567890

invoice_number

string

required

Invoice Number of the bill

type

enum<string>

Bill Type

required

Bill type

Allowed values:

openclosepartial

Example:

close

name

string

required

Bill name

Example:

SPP Januari 2022

customer_name

string

required

Customer name

customer_email

string

optional

customer_phone

string

optional

customer_address

string

optional

total_amount

number

required

Bill's total amount

billed_amount

number

required

Amount billed of total_amount

paid_amount

number

required

Paid amount of total_amount

status

enum<string>

required

Allowed values:

paidactivevoidreversalexpired

ext_description

string | null

optional

description

string | null

required

valid_until

string

optional

Time until bill is invalid.
Date Time is in ISO8601 format

Example:

2022-04-05T13:32:08+07:00

created_at

string

required

Bill created date in ISO8601 format

Example:

2022-04-05T13:32:08+07:00

components

array[object (Bill's component) {5}]

required

Bill's Component

additional_data

optional

Example

{
    "rc": "SUCCESS",
    "message": "success",
    "timestamp": "2022-04-05T06:11:58+07:00",
    "data": {
        "hash": "x24da1dF",
        "va_number": "8673011234567890",
        "type": "open",
        "invoice_number": "INV-02-00001",
        "name": "SPP Bulan Januari",
        "customer_name": "John Doe",
        "customer_email": "john.doe@example.com",
        "customer_phone": "+621234567890",
        "customer_address": "Surabaya, Indonesia",
        "total_amount": 100000,
        "billed_amount": 100000,
        "paid_amount": 0,
        "description": "Pembayaran SPP Bulan Januari",
        "ext_description": "-",
        "valid_until": "2022-04-05T13:32:08+07:00",
        "status": "active",
        "created_at": "2022-04-04T06:32:08+07:00",
        "components": [
            {
                "id": "95f5c77f-79de-4c12-a151-ef7c68e9b7d2",
                "name": "SPP Januari",
                "qty": "1",
                "price": "100000",
                "total": "100000"
            }
        ],
        "additional_data": [
            {
                "key": "class (programming safe), alphanum, snake_case, lowercase",
                "label": "Kelas / Angkatan",
                "value": ""
            }
        ]
    }
}