Bill Payment

Bill Payment merupakan layanan yang digunakan untuk memproses transaksi. Dalam proses Bill Payment, terjadi 2 transaksi yaitu pemotongan saldo dan menyelesaikan status transaksi.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/biller/paymentreport
Production
https://api.espay.id/rest/biller/paymentreport

Authorization

Setiap permintaan yang dikirim, harus memerlukan otentikasi menggunakan Basic Authentication. Pastikan Anda menambahkan Authorization pada header. Pelajari lebih lanjut Authorization.

Authorization: Basic {base64(username:password)}
Key Value
Method
POST
HTTP Version
HTTP/1.0
Accept
*/*
Content-Length
<dynamic>
Content-Type
application/x-www-form-urlencoded
Authorization
Basic base64(username:password)

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

Format:
Sender_id + Unik ID

Contoh:
SENDERID123ABC-DEF456
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

Format:
YYYY-MM-DD HH:MM:SS

Contoh:
2024-12-17 12:30:45
sender_id
String (50)
Y
Kode identitas merchant yang diberikan oleh tim Espay.
channel_code
String (32)
C
...
password
String (3)
Y
Kata sandi yang diberikan oleh tim Espay.
order_id
String (3)
Y
Kode unik untuk identifikasi transaksi.

Contoh:
Nomor handphone, nomor kartu kredit, customer id, dll.
product_code
String (16)
Y
Kode produk. Lihat kode produk
amount
String (17)
Y
Total tagihan yang harus dibayar.

Format:
Desimal (,00)

Contoh:
150.000,00
additional_data
String (999)
C
Detail transaksi dengan format berdasarkan produk.

Silahkan kunjungi halaman produk biller yang Anda gunakan untuk mengetahui detail data transaksi. Produk Biller data transaksi.
signature
String (999)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Signature
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server Espay.

Format:
yyyy-MM-dd hh:mi:ss

Contoh:
2024-03-14 07:49:28
error_code
String (4)
Y
Kode respons.
error_desc
String (128)
Y
Deskripsi respons.
order_id
String (64)
Y
Kode unik untuk identifikasi transaksi.

Contoh:
Nomor handphone, nomor kartu kredit, customer id, dll.
description
String (128)
C
Deskripsi transaksi.
data
String (999)
Y
Detail transaksi dengan format berdasarkan produk.

Silahkan kunjungi halaman produk biller yang Anda gunakan untuk mengetahui detail data transaksi. Produk Biller data transaksi.
Y: Yes, O: Optional, C: Conditional








































Contoh Permintaan

POST /rest/biller/paymentreport HTTP/1.0
Host: sandbox.api.espay.id
Content-Length: 124
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
Content-type: application/x-www-form-urlencoded


rq_uuid=4328662&
rq_datetime=2014-12-11 15:21:15&
sender_id=SENDERID&
password=espaypass&
order_id=9900990099&
product_code=STCKAI&
amount=35000000&
data={
    "ticket_no": "9900990099",
    "reserved1": "",
    "reserved2": "",
    "bill_total": "1",
    "passenger_name": "Andreanus Hendy",
    "train_number": "KA 16",
    "train_name": "ARGO GEDE",
    "train_seat": "39A",
    "info": [
        {
            "trip_info": "JKTSBY0000",
            "trip_info_extended": "23072340"
        }
    ]
}&
signature=c26a2a9901941a2eefd
































Contoh Respons Positif

{
    "rq_uuid":"4328662",
    "rs_datetime":"2014-12-09 15:21:15",
    "error_code":"0000",
    "error_desc":"COMPLETED SUCCESFULLY",
    "order_id":"9900990099",
    "description":"Pembayaran tiket KAI",
    "data":{
        "ticket_no":"9900990099",
        "reserved1":"",
        "reserved2":"",
        "bill_total":"1",
        "passenger_name":"Andreanus Hendy",
        "train_number":"KA 16",
        "train_name":"ARGO GEDE",
        "train_seat":"39A",
        "info":[
            {
                "trip_info":"JKTSBY0000",
                "trip_info_extended":"23072340"
            }
        ]
    }
}




cURL


curl --location 'https://sandbox-api.espay.id/rest/merchantpg/sendinvoice' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'rq_uuid=abcbd39734-ed32-490d-98c4-e91bcd91037b' \
--data-urlencode 'rq_datetime=2024-04-30 17:48:24' \
--data-urlencode 'order_id=ORDER004' \
--data-urlencode 'amount=890000' \
--data-urlencode 'ccy=IDR' \
--data-urlencode 'comm_code=SGWDIGALLERY' \
--data-urlencode 'remark1=082138802290' \
--data-urlencode 'remark2=TravelAja OTA Web Tiara Iyay' \
--data-urlencode 'remark3=test@gmail.com' \
--data-urlencode 'remark4=' \
--data-urlencode 'update=N' \
--data-urlencode 'bank_code=014' \
--data-urlencode 'va_expired=30' \
--data-urlencode 'signature=d4787b96b6ee30036e42cf54bbf346559a8200feb0ce81a1df74231759990e31'








































Scroll to Top