Version: 2.1.0
Last Updated: 09th Dec, 2025

Get started

    API Endpoint

        Prod : https://ppob.alton.id/api/altppob/
        Dev  : https://ppob.alton.id/api/devppob/

API PPOB menyediakan akses terprogram untuk menangani berbagai operasi Payment Point Online Banking. Proses transaksi prabayar dan pascabayar, periksa tagihan pelanggan, validasi informasi produk, ambil riwayat transaksi, filter laporan, dan banyak lagi.

Untuk menggunakan API ini, Anda memerlukan Username,Password & Jwt Key yang tersedia di akun PPOB anda. Silakan hubungi kami di info@alton.id untuk mendapatkan akun.

Enkripsi JWT menggunakan HS256. Anda dapat melakukan encode decode di JWT.IO menggunakan JWT key yang tersedia di akun anda.

get Token


Header:
{
 "Authorization": "Basic Y29iYUBwcG9iLmFsdG9uOjEyMzQ1Ng==",
 "Content-Type": "application/x-www-form-urlencoded"
 }
Request:
{
 "grant_type": "client_credentials",
 }

Untuk melakukan proses selanjutnya anda harus mendapatkan token agar dapat menjalankan service berikutnya :
Method : POST
Type : JSON
Prod : https://ppob.alton.id/api/altppob/token
Dev : https://ppob.alton.id/api/devppob/token 



Result success example :

{
 "error": false,
 "description": "success",
 "data": {
 "access_token": "4f1e9603bdd8022b5739611c8dea7d66e07dd6013963e00e3f536f125d866961",
 "expired_at": "2025-12-08 23:59:59"
 }
}



Result error :

{
 "error": true,
 "description": "Authorization Failed",
 "data": false
}

HEADER

Field Value Description
Content-Type application/x-www-form-urlencoded
Authorization Basic base64encode(username:password) username dan password yang diberikan oleh PPOB Alton Mitra Sejahtera

QUERY PARAMETERS

Field Type Description
grant_type String diisi dengan "client_credentials"

Inquiry


# example
Header:
 {
    "Authorization": "Bearer e75ca3cfe0c0393d52b84b6329ce9dcf840f95a7c0ead359681a2ef1e3dfa76a",
    "Content-Type": "text/plain"
 }

Request:
{
    "method": "inquiry",
    "refno": "20251204001",
    "jenis": "PULSA",
    "idpel": "085230784187"
 }

Inquiry transaksi :
Method : POST
Type : JWT
Prod : https://ppob.alton.id/api/altppob/inquiry
Dev : https://ppob.alton.id/api/devppob/inquiry 



Result success example :

{
   "response": "000",
   "message": "Sukses",
   "data": {
      "jenis": "TELKOMSEL",
      "ppob": [
         {
            "kode": "SS5",
            "nama": "TELKOMSEL",
            "keterangan": "5000",
            "harga": 5695,
            "admin": "0.00"
         },
         {
            "kode": "SS10",
            "nama": "TELKOMSEL",
            "keterangan": "10000",
            "harga": 10570,
            "admin": "0.00"
         }
      ]
   }
}


Result error example : 

{
 "response": "094",
 "message": "ID Pelanggan tidak valid",
 "data": false
}

QUERY PARAMETERS

Field Type Description
method String Diisi dengan "inquiry"
refno String String acak yang bersifat unik
jenis String Jenis produk yang dipilih
idpel String Nomor Handphone / Id pelanggan

Inquiry Cek


# example
Header:
 {
    "Authorization": "Bearer e75ca3cfe0c0393d52b84b6329ce9dcf840f95a7c0ead359681a2ef1e3dfa76a",
    "Content-Type": "text/plain"
 }

Request:
{
    "method": "inquiry",
    "refno": "20251204001",
    "jenis": "PULSA",
    "idpel": "085230784187"
 }

Inquiry Cek transaksi :
Method : POST
Type : JWT
Prod : https://ppob.alton.id/api/altppob/inquiry-cek
Dev : https://ppob.alton.id/api/devppob/inquiry-cek 



Result success example :

{
   "response": "000",
   "message": "Sukses",
   "data": {
      "kode": "TELKOMSEL",
      "jenis":"01",
      "nama":"TELKOMSEL",
      "keterangan":"10000",
      "nominal":10500.00,
      "harga":10570.00,
      "admin":0,
      "total":10570.00
   }
}


Result error example : 

{
 "response": "080",
 "message": "Method Tidak Tersedia",
 "data": false
}

QUERY PARAMETERS

Field Type Description
method String Diisi dengan "inquiry"
refno String String acak yang bersifat unik
jenis String Jenis produk yang dipilih
idpel String Nomor Handphone / Id pelanggan

Payment


# example
Header:
{
 "Authorization": "Bearer ff2e1d3d1610c74dbb32305fca869b454f54ea691c9a8944d7b27b0804228c93",
 "Content-Type": "text/plain"
 }


Request:
{
 "method": "payment",
 "refno": "20251204001",
 "kode": "SS10",
 "idpel": "085230784187",
 "nominal":10570
}

Payment transaksi :
Method : POST
Type : JWT
Prod : https://ppob.alton.id/api/altppob/payment
Dev : https://ppob.alton.id/api/devppob/payment 



Result example :

{
 "response": "000",
 "message": "SN 12214124912923798132",
 "data": {
 "harga": 10570,
 "idpel": "085230784187"
 }
}

Result error example :

{
 "response": "093",
 "message": "Nominal Pembayaran tidak valid",
 "data": false
}

QUERY PARAMETERS

Field Type Description
method String Diisi dengan "payment".
refno String String acak yang bersifat unik
kode String Kode yang didapat dari hasil inquiry
idpel String Nomor Handphone / Id pelanggan
nominal integer Nominal pembayaran

Reversal


# example
https://ppob.alton.id/api/devppob/reversal/?serverid=41061758&clientid=1725983708255668&statuscode=2&kp=SDN
3&msisdn=085230784187&msg=TELKOMSELFLASH BERHASIL SN:1234567890 SALDO:125000
&msg= TELKOMSELFLASH BERHASIL SN:1234567890 SALDO:125000

Refersal transaksi :
Method : GET
Type : JSON
Prod : https://ppob.alton.id/api/altppob/payment
Dev : https://ppob.alton.id/api/devppob/payment 



Result success example :

SUKSES

Result error example :

GAGAL

QUERY PARAMETERS

Field Type Description
serverid String Server ID
clientid String Client ID
statuscode String Status transaksi
kp String Kode Produk
msg String Pesan dari response sukses

List Products

Daftar produk yang digunakan:

Nama Produk
PULSA
PAKET DATA
PLN PRABAYAR
DANA
GOPAY
LINK AJA
OVO
SHOPEE PAY
PLN PASCABAYAR
TELKOM
PGN
MATRIX POSTPAID
THREE POSTPAID
XL POSTPAID
SMARTFREN POSTPAID
HALO POSTPAID
BPJS KESEHATAN
TV BERLANGGAN
PDAM
MULTI FINANCE

Errors

Error code yang digunakan:

Error Code Meaning
000 Sukses
099 Transaksi Gagal
098 Kode produk tidak tersedia
097 Kode produk tidak aktif
096 Host sedang offline
095 Inquiry gagal
094 ID Pelanggan tidak valid
093 Nominal pembayaran tidak valid
092 Pembayaran gagal
091 Pembayaran sudah dilakukan untuk hari ini
090 Pembayaran sedang dalam proses
088 Data pelanggan tidak valid
087 Ref ID tidak ditemukan
086 Tagihan sudah dibayar
0088 Tagihan sudah dibayar
085 Transaksi tidak dapat dilakukan
084 Transaksi tidak dapat dilakukan, cut off time
083 Inquiry produk tidak tersedia
082 Kode produk tidak diperbolehkan
081 Transaksi Suspect
080 Method Tidak Tersedia
079 Request Tidak Lengkap
022 Host sedang offline
006 Host sedang offline
014 Host sedang offline
008 Refund
011 Deposit Tidak Mencukupi
068 Transaksi Suspect
060 Time out