POST | Callback | Tokopedia Seller API

Callback

The purpose of this payload is for Tokopedia to reconfirm the transaction state, only if the partner is implementing asynchronous transactions processing. Tokopedia will hit this payload based on partner requirements. Callback response and status will be used as a transaction final state, if pending is given, check status will be performed. When the callback arrives after the check status returned response code Success (00) /Failed (01), callback will be ignored.

Request

Key	Value	Required	Description
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
additional_details	array of bill_details with label	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 checkout page to show the user their bill information

Unencrypted & Unsigned (Plain Payload) Success Example

{
  "ref_id": "11242905512",
  "partner_ref_id": "ABC123456789",
  "partner_inquiry_id": "1234567890",
  "response_code": "00",
  "message": "Success",
  "due_date": "2021-12-21",
  "bill_generation_date": "2021-12-01",
  "is_open_amount": false,
  "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
        }
      ]
    }
  ]
}

Unencrypted & Unsigned (Plain Payload) Failed Example

{
  "ref_id": "11242905512",
  "partner_ref_id": "ABC123456789",
  "partner_inquiry_id": "1234567890",
  "response_code": "11",
  "message": "Bill not available",
  "timestamp": "2021-12-12 12:12:12"
}

Response

Decrypted & Verified (Plain Payload) Success Example

{
  OK
}

Decrypted & Verified (Plain Payload) Failed Example

{
  Server Error - 811
}

Callback​

Callback