.png?sv=2022-11-02&spr=https&st=2025-06-26T21%3A19%3A15Z&se=2025-06-26T21%3A36%3A15Z&sr=c&sp=r&sig=A22Gh743wf%2BTT73l2bQbH7hCyBLFaxwVk2xxQ1HdqNo%3D)
Testing your Bill Payments integration thoroughly is essential to ensure a smooth experience for your users. This section provides test scenarios specifically for PLN (Perusahaan Listrik Negara) bill payments, which can serve as a foundation for testing other bill payment types as they become available.
PLN Test Scenarios
PLN offers two types of electricity payments: Prepaid (token) and Postpaid (monthly bill). Below are test scenarios for both types.
PLN Prepaid (Token) Test Scenarios
Positive
Negative
PLN Postpaid Test Scenarios
Positive
Negative
Example Request and Response
Example 1: PLN Prepaid Token Purchase
Product List Request:
GET /v1/product?category=ELECTRICITY
Response:
{
"limit": 50,
"cursor": "dummy-cursor-value-001==",
"data": [
{
"type": "product",
"id": "PLN_PREPAID_100K",
"properties": {
"product_name": "PLN Prepaid 100.000",
"category": "ELECTRICITY",
"biller": "PLN",
"country": "ID",
"currency": "IDR",
"requires_inquiry": true,
"availability_status": "AVAILABLE",
"admin_amount": 2750,
"base_amount": 100000,
"total_amount": 102750,
"revenue_share_amount": 500,
"locale": {
"en": "PLN Prepaid 100.000",
"id": "PLN Prabayar 100.000"
}
}
}
]
}
Inquiry Request:
{
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159194"
}
Inquiry Response:
{
"data": {
"business_id": "5f27a14a9bf05c73dd040bc8",
"type": "inquiry",
"id": "inq-98765",
"properties": {
"product_id": "PLN_PREPAID_100K",
"admin_amount": 2750,
"base_amount": 100000,
"total_amount": 102750,
"revenue_share_amount": 500,
"currency": "IDR",
"customer_number": "32185159194",
"customer_details": [
{
"key": "Nama Pelanggan",
"value": "Ismail Rabbanii"
},
{
"key": "Nomor Pelanggan",
"value": "32185159194"
}
],
"product_details": [
{
"key": "Tarif/Daya",
"value": "R2/000003500"
},
{
"key": "Denom",
"value": "100.000"
}
],
"bill_details": [
{
"key": "Admin Fee",
"value": "Rp2.750"
},
{
"key": "Total Bayar",
"value": "Rp102.750"
}
]
}
}
}
Payment Request:
{
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159194",
"inquiry_id": "inq-98765",
"reference_id": "tx-pln-001",
"total_amount": 102750,
"additional_properties": {
"payment_reference": "sfinhsiof2309rr3"
}
}
Payment Response:
{
"data": {
"business_id": "5f27a14a9bf05c73dd040bc8",
"type": "payment",
"id": "trx-98765",
"properties": {
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159194",
"reference_id": "tx-pln-001",
"admin_amount": 2750,
"base_amount": 100000,
"total_amount": 102750,
"currency": "IDR",
"status": "PENDING",
"fulfilled_at": null,
"failure_code": null,
"failure_reason": null,
"customer_details": [],
"product_details": [],
"bill_details": [],
"payment_details": []
}
}
}
Successful Payment Callback:
{
"business_id": "5f27a14a9bf05c73dd040bc8",
"created": "2024-01-23T08:15:30Z",
"event": "bill_payments.succeeded",
"data": {
"id": "trx-98765",
"properties": {
"reference_id": "tx-pln-001",
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159194",
"total_amount": 102750,
"status": "SUCCEEDED",
"fulfilled_at": "2024-01-23T08:15:30Z"
}
}
}
Get Payment Detail Request:
GET /v1/payment/trx-98765
Successful Response:
{
"data": {
"business_id": "5f27a14a9bf05c73dd040bc8",
"type": "payment",
"id": "trx-98765",
"properties": {
"reference_id": "tx-pln-001",
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159194",
"admin_amount": 2750,
"base_amount": 100000,
"total_amount": 102750,
"status": "SUCCEEDED",
"fulfilled_at": "2024-01-23T08:15:30Z",
"failure_code": null,
"failure_reason": null,
"customer_details": [
{
"key": "Nama Pelanggan",
"value": "Ismail Rabbanii"
},
{
"key": "Nomor Pelanggan",
"value": "32185159194"
}
],
"product_details": [
{
"key": "Tarif/Daya",
"value": "R2/000003500"
}
],
"bill_details": [
{
"key": "Admin Fee",
"value": "Rp2.750"
},
{
"key": "Total Bayar",
"value": "Rp102.750"
}
],
"payment_details": [
{
"key": "Token",
"value": "1234-5678-9012-3456-7890"
},
{
"key": "Serial Number",
"value": "PLN987654321"
}
]
}
}
}
Example 2: Failed Transaction (System Timeout)
Payment Response (same endpoint as successful case):
{
"data": {
"business_id": "5f27a14a9bf05c73dd040bc8",
"type": "payment",
"id": "trx-98768",
"properties": {
"reference_id": "tx-pln-002",
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159195",
"admin_amount": 2750,
"base_amount": 100000,
"total_amount": 102750,
"currency": "IDR",
"status": "PENDING",
"fulfilled_at": null,
"failure_code": null,
"failure_reason": null,
"customer_details": [],
"product_details": [],
"bill_details": [],
"payment_details": []
}
}
}
Failed Payment Callback:
{
"business_id": "5f27a14a9bf05c73dd040bc8",
"created": "2024-01-23T08:30:00Z",
"event": "bill_payments.failed",
"data": {
"id": "trx-98768",
"reference_id": "tx-pln-002",
"product_id": "PLN_PREPAID_100K",
"customer_number": "32185159195",
"total_amount": 102750,
"status": "FAILED",
"fulfilled_at": "2024-01-23T08:30:00Z",
"failure_code": "BILLER_TIMEOUT",
"failure_reason": "Biller system timeout after 30 seconds"
}
}
Testing Best Practices
Test all scenarios: Implement both positive and negative test cases.
Verify callback handling: Ensure your system correctly processes both success and failure callbacks.
Check idempotency: Verify that duplicate requests are handled properly.
Test timeout scenarios: Simulate timeouts to ensure your system handles them gracefully.
Validate error messages: Ensure error messages are user-friendly and actionable.
Test status checking: Verify that your status checking mechanism works as a fallback.
By thoroughly testing with these scenarios, you'll ensure your Bill Payments integration provides a smooth experience for your users while properly handling edge cases and error conditions.