Introduction
Payment Gateway
Integration
Your Account
Tagih.id
Payment Notification
Payment Notification is a service that Espay uses to notify you that an invoice payment has been successfully made. You must respond in the specified format and register your Payment Notification URL in the Espay Sandbox Portal.
Flow
Whenever an invoice payment is successfully collected, Tagih.id will send a request to your server via the Payment Notification URL registered in the Espay Sandbox Portal. You are required to respond in JSON format using the format provided.
API URL
| Method | URL |
|---|---|
|
HTTPS |
https://yourwebsite.com/payment |
HTTP Headers
| Key | Value |
|---|---|
|
Method |
POST |
|
HTTP Version |
HTTP/1.1 |
|
Accept |
*/* |
|
Content-Type |
application/x-www-form-urlencoded |
|
Content-Length |
<dynamic> |
Parameter Request
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
|
rq_uuid |
String (64) |
Y |
Request identifier. A unique ID used to identify messages.
Format: UUID V.4 Recommendation |
|
rq_datetime |
String (19) |
Y |
Date and time of the transaction request.
Format: Y-m-d H:i:s Example: 2024-12-16 14:30:45 |
|
sender_id |
String |
Y |
Sender code.
Value: sgoplus |
|
receiver_id |
String (10) |
Y |
The merchant community code shown in the Tagih.id app. |
|
password |
String (32) |
Y |
Password from Espay team. Merchant uses the password to identify and validate request. |
|
comm_code |
String (32) |
Y |
Merchant region code.
Example: SGWYESSISHOP |
|
member_code |
String (32) |
Y |
Member code. |
|
member_cust_id |
String |
O |
Unique customer code from Espay. |
|
member_cust_name |
String |
O |
The member_name parameter from the Send Multiple request. |
|
ccy |
String (3) |
Y |
Transaction currency code.
Format:
|
|
amount |
String (13.2) |
Y |
Total invoice amount.
Example: 200000 |
|
debit_from |
String (19) |
O |
Source account (debited account). |
|
debit_from_name |
String (64) |
O |
Source account name. |
|
debit_from_bank |
String (20) |
Y |
Source account bank code.
Example : 008, 016, 002, dll. |
|
credit_to |
String (19) |
O |
Destination account (credited account). |
|
credit_to_name |
String (64) |
O |
Destination account name. |
|
credit_to_bank |
String (20) |
Y |
Destination account bank code.
Example : 008, 016, 002, dll. |
|
payment_datetime |
String (19) |
Y |
Tanggal dan waktu pembayaran.
Format: YYYY-MM-DD hh:mm:ss Contoh: 2025-08-11 15:42:30 |
|
payment_ref |
String (16) |
Y |
Transaction ID from Espay. |
|
payment_remark |
String |
O |
Conditional note for the customer. |
|
order_id |
String (20) |
Y |
Unique code to identify the order/billing/invoice.
Example: Transaction number, invoice ID, etc. |
|
product_code |
String (32) |
Y |
Product code. Click here |
|
product_value |
String (64) |
O |
Product value
Example: Visa MANDIRI ID, 002, 411111xxxxxx1111, Tipe kartu Bin kartu Negara kartu, Bank acquirer, Masking kartu. |
|
message |
String (32) |
O |
Additional info from the bank. |
|
status |
String (1) |
O |
Espay internal info. |
|
token |
String (128) |
O |
Token credit card from bank. |
|
fee_type |
String (5) |
O |
Fee type.
Format:
|
|
tx_fee |
String (17) |
Y |
Transaction fee.
Format: Desimal .00 (ISO 4217) Example: 4400 |
|
is_snap |
String (1) |
O |
SNAP status mapping. |
|
invoices |
JSON |
Y |
Detail invoices. |
|
total_amount |
String (13.2) |
Y |
Total amount has been collected.
Format: 250000 |
|
notes |
String |
O |
Additional information. |
|
member_id |
Sting (20) |
O |
Merchant code registered in the Espay system. |
|
signature |
String |
Y |
Code used to validate transactions. Learn how to make a Tagih.id | Hash-Based Signature |
Y: Yes,
O: Optional,
C: Conditional
Parameter Response
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
|
rq_uuid |
String (64) |
Y |
Request identifier. A unique ID used to identify messages |
|
rs_datetime |
String |
Y |
Date and time of the transaction response.
Format: yyyy-MM-dd hh:mi:ss Format: 2024-03-14 07:49:28 |
|
error_code |
String (4) |
Y |
Response code:
Format:
|
|
error_message |
String |
Y |
Response description. |
|
trx_id |
String (16) |
Y |
Transaction ID from Espay. |
|
reconcile_id |
String (20) |
Y |
Reconciliation ID. Used to confirm that the partner has successfully received the notification. |
|
reconcile_datetime |
String |
Y |
Reconciliation date and time.
Format: yyyy-MM- ddThh:mi:ssTZD (ISO 8601). Example: 2022-08-21T14:56:11+07:00 |
Y: Yes,
O: Optional,
C: Conditional
URL Registration
Ensure your URL format and response comply with this documentation guidelines. Next, immediately register your Payment URL via the Espay Sandbox portal. Read how to add a URL here.
