Skip to main content

Check Status​

The purpose of this payload is for Tokopedia to reconfirm the transaction state, if during the payment payload, the partner responds with a pending response code and partner implements synchronous transaction processing.

Check status will be called periodically for pending transactions until it is either resolved to Success or Failed. By default it will start with a 5 minutes interval and gradually increase to a 15 minutes interval after several hours. Check status intervals can be configured to meet Tokopedia and Partner’s needs.

Request
KeyValueRequiredDescription
ref_idstringyesUnique reference identifier from Tokopedia (same as payment ref_id)
timestampstringyesIn Jakarta Time GMT+7, Format: YYYY-MM-DD hh:mm:ss
categorystringyesProduct category identifier provided by Tokopedia
Unencrypted & Unsigned (Plain Payload) Example
{
  "ref_id": "11242905512",
  "timestamp": "2021-12-12 12:12:12",
  "category": "listrik"
}
Response
KeyValueRequiredDescription
ref_id
string
yes
Unique reference identifier from Tokopedia (same as payment ref_id)
partner_ref_id
string
yes
Unique reference identifier from Partner
client_number
string
yes
Client bill identifier / MSISDN number
product_code
string
yes
Code of product given by Partner
response_code
string
yes

Response code as specified (see 10. Response Codes)

message
string
yes
Additional informational or error message
admin_fee
number
no
Partner admin fee that already included on total_amount
total_amount
number
yes
Total bill amount or product price
timestamp
string
yes

In Jakarta Time GMT+7, Format: YYYY-MM-DD hh:mm:ss

bill_details
array
no

Details of a given bill

For specific product categories, please refer to Mandatory Responses

additional_details
array
no

Additional details of a given bill that will be shown to the user with a collapsed initial state. This usually is not important yet needs to be displayed to the user.

For specific product categories, please refer to Mandatory Responses

Information details will be used on the invoice page and email notification to show the user their bill information

Decrypted & Verified (Plain Payload) Success Example
{
  "ref_id": "11242905512",
  "partner_ref_id": "ABC123456789",
  "client_number": "1234567890",
  "product_code": "product5627",
  "response_code": "00",
  "message": "Success",
  "total_amount": 1500000,
  "timestamp": "2021-12-12 12:12:12",
  "bill_details": [
    {
      "name": "Nama Perusahaan",
      "value": "Company Lorem",
      "is_pii": false,
      "is_show": true
    },
    {
      "name": "Nama Customer",
      "value": "John Doe",
      "is_pii": true,
      "is_show": true
    }
  ],
  "additional_details": [
    {
      "label": "Pemakaian",
      "details": [
        {
          "name": "Meter awal",
          "value": "120 m2",
          "is_pii": false,
          "is_show": true
        },
        {
          "name": "Meter akhir",
          "value": "150 m2",
          "is_pii": false,
          "is_show": true
        }
      ]
    }
  ]
}
Decrypted & Verified (Plain Payload) Failed Example
{
  "ref_id": "11242905512",
  "response_code": "12",
  "message": "Transaction not found",
  "timestamp": "2021-12-12 12:12:12"
}

Have a feedback?