API Reference

Payment Callback

PAPER.ID has a webhook which will send the payment status whenever there is an update. Please ensure that you have registered the URL callback on the dashboard in order to receive a callback from us.

This callback is catered for a successful/failed payment only, and not catering the disbursement process. The disbursement will be catered on different section (see: disbursement callback)

Parameter:

PathData Type ValidationDescription
ref_idstringPayment Transaction reference ID created by client
payment_datedatePayment Date by customer / buyer in YYYY-MM-DD
messagestringMessage response related to the payment data
payment_infoobjectPayment data and details which had been made by customer / buyer
payment_info.methodstringThe payment method used by customers. Currently we offer: bank_transfer, credit_card, ewallet, qris, mitra_pembayaran_digital.
payment_info.channelstringThe payment channel used by customer that identify which brand/channel that we used for identify specific payment method (e.g: visa, mastercard, ovo, bni, etc)
payment_info.amountdoubleBilled amount that need to be paid by the customer
payment_info.paid_amountdoubleAmount of payment that has been paid by the customer
payment_info.paid_attimestampThe time stamp of successful payment
payment_info.statusstringPayment transaction status. Expect that you will received PAID status for successful payment.
payment_info.updatedtimestampThe time stamp of latest update happens on the payment request
payment_info.sourcestringThe source of the underlying document. Default value: paper-chain, payment_out_request

JSON Payload

{
  "additional_info": {},
  "message": "transaction success",
  "payment_date": "01-01-2021 23:59:59",
  "payment_info": {
    "bank_transfer": {
      "amount": 200000,
      "created": "2021-08-09T11:23:50.550571+07:00",
      "paid_amount": 200000,
      "paid_at": "2021-08-09T11:23:50.550571+07:00",
      "status": "PAID",
      "updated": "2021-08-09T11:23:53.011389+07:00"
    },
    "channel": "bni",
    "method": "bank_transfer",
  },
  "ref_id": "987654xxxxx",
}
{
  "additional_info": null,
  "message": "transaction succeed",
  "payment_date": "2023-08-29",
  "payment_info": {
    "channel": "visa",
    "method": "credit_card",
    "credit_card": {
      "amount": 100000,
      "created": "2023-08-29T12:09:49.187348372+07:00",
      "paid_amount": 100000,
      "paid_at": "2023-08-29T12:10:51.143011605+07:00",
      "status": "PAID",
      "updated": "2023-08-29T12:10:51.143011605+07:00",
      "source": "paper-chain"
    }
  },
  "ref_id": "REF1693285783paQHF"
}
{
  "additional_info": null,
  "message": "transaction succeed",
  "payment_date": "2023-08-29",
  "payment_info": {
    "channel": "ewallet",
    "method": "OVO",
    "ewallet": {
      "amount": 100000,
      "created": "2023-08-29T12:12:58.750848281+07:00",
      "paid_amount": 100000,
      "paid_at": "2023-08-29T12:13:02.53221859+07:00",
      "status": "PAID",
      "updated": "2023-08-29T12:13:02.53221859+07:00",
      "source": "paper-chain"
    }
  },
  "ref_id": "REF1693285978PKnAn"
}
{
  "additional_info": null,
  "message": "transaction succeed",
  "payment_date": "2023-08-29",
  "payment_info": {
    "channel": "tokopedia", //or tokopedia_cc, blibli, shopee
    "method": "mitra_pembayaran_digital",
    "mitra_pembayaran_digital": {
      "amount": 100000,
      "created": "2023-08-29T11:53:12.475422622+07:00",
      "paid_amount": 100000,
      "paid_at": "2023-08-29T11:54:19.135087699+07:00",
      "status": "PAID",
      "updated": "2023-08-29T11:54:19.135087699+07:00",
      "source": "paper-chain"
    }
  },
  "ref_id": "REF1693284791uZVQR"
}
{
  "additional_info": null,
  "message": "transaction succeed",
  "payment_date": "2023-08-29",
  "payment_info": {
    "channel": "qris",
    "event": "qr.payment",
    "method": "qris",
    "ewallet": {
      "amount": 100000,
      "created": "2023-08-29T12:15:40.397707662+07:00",
      "paid_amount": 100000,
      "paid_at": "2023-08-29T12:16:15.633467823+07:00",
      "status": "PAID",
      "updated": "2023-08-29T12:16:15.633467823+07:00",
      "source": "paper-chain"
    }
  },
  "ref_id": "REF1693286139cxCtu"
}