PPOB Service
The PPOB (Payment Point Online Bank) service allows you to automatically process digital product transactions such as credit, data packages, PLN tokens, and postpaid bills through a single unified API connection.
Get Product List
Retrieve the list of available products, base prices, and real-time status from all providers connected to the STSPoint ecosystem.
Query Parameters
| Parameter | Type | Status | Description |
|---|---|---|---|
| secret_key | String | Required | Your API secret key for authentication. |
| type | Enum | Optional | Filter product type: prepaid or pasca. |
Response Example (Product Array)
{
"success": true,
"data": [
{
"buyer_sku_code": "TSEL10",
"product_name": "Telkomsel 10,000",
"category": "Credit",
"brand": "TELKOMSEL",
"type": "Prepaid",
"price": 10250,
"buyer_product_status": true,
"desc": "Telkomsel Regular Credit 10k"
}
]
}Place Order
Send transaction instructions to the bridge server to be processed by the provider. Your balance will be deducted automatically for Prepaid products.
Request Body (JSON)
| Parameter | Type | Description |
|---|---|---|
| secret_key | String | Your API secret key. |
| sku | String | Product SKU code (obtained from GET /ppob/order). |
| target | String | Destination number (Phone, Meter No, Customer ID). |
| ref_id | String | Your system's unique transaction ID (External ID). |
| qty | Number | Nominal pembayaran untuk tipe Pasca (Wajib untuk Postpaid). |
Implementation Snippets
curl -X POST https://api.stspoint.id/ppob/order \ -H "Content-Type: application/json" \ -H "X-Callback-URL: https://your-server.com/ppob-webhook" \ -d '{ "secret_key": "STS-Key-XXXXXXXX", "sku": "TSEL10", "target": "081234567890", "ref_id": "ORDER-9921" }'
Order Success Response
{
"success": true,
"message": "Transaction is being processed",
"data": {
"ref_id": "ORDER-9921",
"sku": "TSEL10",
"target": "081234567890",
"status": "Pending"
}
}Check Order Status
Synchronize transaction status manually using the ref_id you sent during order creation.
{
"success": true,
"status": "Success",
"message": "Transaction successful",
"data": {
"ref_id": "ORDER-9921",
"sku": "TSEL10",
"target": "081234567890",
"status": "Success"
}
}Real-time Callbacks
Use the X-Callback-URL header to receive automatic notifications when a transaction status changes to Success or Failed.
{
"event": "ppob.status_update",
"data": {
"ref_id": "ORDER-9921",
"sku": "TSEL10",
"target": "081234567890",
"status": "Success",
"sn": "83294829384923",
"message": "Transaction successful",
"timestamp": "2024-10-24T08:42:11Z"
}
}Security Header
Every webhook will include an X-STS-Signature header (HMAC-SHA256) to ensure the data originates from official STSPoint infrastructure.