📘
Notes:
For this part, we also provide the user journey. You can check the API documentation after user journey section.

User Journey

1) Check User Data

In this step, the user will input their NIK (Residence number of Indonesia) into the form (screen 1) and check if their data is already registered in BPJS TK or not.

2) Verify User Data

In this step, the user will verify their data with the data from the government that is stored in the BPJS server. They need to input some data in this form

NIK: Residence numbers
Nama pada KTP: name in residence ID card Tanggal Lahir pada KTP: Date of birth in residence ID card Nomor HP: Phone number

3) Registration User Data

In addition to the form in step 2, the user needs to add some additional info in this step (screen 5-a, b)

Additional data:

Alamat pada KTP: address in residence ID card
Kantor Cabang BPJS: choose from the given list
Jenis Pekerjaan: choose from the given list
Lokasi Pekerjaan (Provinsi): choose from given list
Lokasi Pekerjaan (Kota): choose from given list
Jam Kerja: Working hours (screen 5-b)

4) Input Bills Calculation

After registration is complete, users will continue to fill in the option of the program that they want to choose. The data that they need to fill in this step is:

Upah bulanan: their monthly income
Pilih program: choose the program that they want to follow
Pilih bulan: choose how long they want to join the program.

API Documentation

Enrollment API

{
  "partnerId" : "ayopop",
  "account_number" : "212438232700001",
  "product_code" : "TBPBU",
  "ref_number" : "4544578"
}

{
    "responseCode": 200,
    "success": true,
    "message": {
        "id": "Success.",
        "en": "Success."
    },
    "data": {
        "ayoconnect_ref_number": "14174",
        "accountNumber": "0811111111111",
        "productName": "product-name",
        "productCode": "product-code",
        "category": "BPJS",
        "url": "https://example.com?ID=166269397200254"
    }
}

Callback API

{
    "responseCode": 200,
    "success": true,
    "message": {
        "ID": "Success",
        "EN": "Success"
    },
    "data": {
        "ayoconnectRefNumber":"12121",
        "enrolmentId": "3519011402980002",
        "refNumber": "4544578",
        "extraDetails": [
          {
            "key": "bulan",
            "value": "1"
          }
        ]
    }
}

Inquiry

{
  "partnerId": "partner-id",
  "accountNumber": "3519011402980002",
  "productCode": "product-code",
  "month": 1
}

{
    "responseCode": 300,
    "success": true,
    "message": {
        "ID": "Inkuiri berhasil",
        "EN": "Inquiry is successful"
    },
    "data": {
        "inquiryId": 2848088,
        "accountNumber": "5519011402980002",
        "customerName": "TEST",
        "productName": "product-name",
        "productCode": "product-code",
        "category": "BPJS",
        "amount": 19300,
        "totalAdmin": 2500,
        "processingFee": 0,
        "denom": "",
        "validity": "",
        "customerDetails": [
            {
                "key": "Nama",
                "value": "TEST"
            },
            {
                "key": "NIK / ID Billing",
                "value": "9800020811111111111"
            },
            {
                "key": "Tanggal & Waktu Pembayaran",
                "value": "10:35 | 09 Sep 2022"
            }
        ],
        "billDetails": [
            {
                "billId": "1",
                "billInfo": [
                    {
                        "key": "Iuran JHT",
                        "value": "0"
                    },
                    {
                        "key": "Iuran JKK",
                        "value": "10000"
                    },
                    {
                        "key": "Iuran JKM",
                        "value": "6800"
                    }
                ],
                "isMandatory": true,
                "key": "Total Iuran",
                "value": 16800
            },
            {
                "billId": "0",
                "billInfo": [],
                "isMandatory": true,
                "key": "Biaya Transaksi",
                "value": 2500
            }
        ],
        "productDetails": [
            {
                "key": "Tanggal Efektif Masa Perlindungan",
                "value": "09-09-2022 "
            },
            {
                "key": "Tanggal Berakhir Masa Perlindungan",
                "value": "08-10-2022 "
            },
            {
                "key": "Kantor Cabang",
                "value": "MADIUN"
            },
            {
                "key": "Kode Iuran",
                "value": "811111111111"
            }
        ],
        "extraFields": [
            {
                "key": "Tunggakan",
                "value": "N/A"
            }
        ]
    }
}

Payment

{
  "partnerId": "ayopop",
  "refNumber": "8we8dn8cen3",
  "accountNumber": "5519011402980002",
  "productCode": "product-code",
  "amount": 19300,
  "inquiryId": 2848088
}

{
    "responseCode": 0,
    "success": true,
    "message": {
        "ID": "Transaksi Anda Telah Berhasil",
        "EN": "Your transaction was successful"
    },
    "data": {
        "refNumber": "8we8dn8cen3",
        "transactionId": 184453,
        "accountNumber": "5519011402980002",
        "amount": 19300,
        "totalAdmin": 2500,
        "processingFee": 0,
        "denom": "",
        "productCode": "TBPBU",
        "productName": "BPJS TK BPU",
        "category": "BPJS",
        "token": "JKK166269451515069#JKM166269451515069",
        "customerName": "TEST",
        "validity": "",
        "customerDetails": [
            {
                "key": "Nama",
                "value": "TEST"
            },
            {
                "key": "NIK / ID Billing",
                "value": "5519011402980002"
            },
            {
                "key": "Tanggal & Waktu Pembayaran",
                "value": "10:37 | 09 Sep 2022"
            }
        ],
        "billDetails": [
            {
                "billId": "1",
                "billInfo": [
                    {
                        "key": "Iuran JHT",
                        "value": "0"
                    },
                    {
                        "key": "Iuran JKK",
                        "value": "10000"
                    },
                    {
                        "key": "Iuran JKM",
                        "value": "6800"
                    }
                ],
                "key": "Total Iuran",
                "value": 16800
            },
            {
                "billId": "0",
                "billInfo": [],
                "key": "Biaya Transaksi",
                "value": 2500
            }
        ],
        "productDetails": [
            {
                "key": "Tanggal Efektif Masa Perlindungan",
                "value": "09-09-2022 "
            },
            {
                "key": "Tanggal Berakhir Masa Perlindungan",
                "value": "08-10-2022 "
            },
            {
                "key": "Kantor Cabang",
                "value": "MADIUN"
            },
            {
                "key": "Nomor Kepesertaan",
                "value": "-"
            },
            {
                "key": "Nomor Referensi",
                "value": "AYO166269451515069"
            },
            {
                "key": "Kode Iuran",
                "value": "5519011402980002"
            }
        ],
        "extraFields": []
    }
}