Skip to main content

Find Invoice

This API is used to find invoices by id.

Spesification

API NameFind Invoice
Http MethodGET
Path.../api/find/{id}

The mandatory headers that must be sent at the time of the request are:

HeaderDescription
X-Winpay-TimestampTime of transaction date, with format YYYY-MM-DDTHH:mm:ss+07:00. Time must be GMT+7 (time Jakarta)
X-Winpay-SignatureSignature generated by the merchant
X-Winpay-KeyClient key merchant
Content-Typemust application/json

Response

The following is the body response that will be received

ParametersData TypeDescription
responseCodestringresponse code
responseMessagestringresponse message
responseDatedateresponse date
responeDatajson element-
responeData.idstringTransaction ID
responeData.refstringReference number for the related transaction
responeData.created_atdatetransaction date created
responeData.back_urlstringThe URL that is directed to or displayed after the customer has completed the payment
responeData.statusstringPayment status
responeData.customerjson element-
responeData.customer.namestringCustomer name
responeData.customer.emailstringcustomer service email
responeData.customer.phonestringcustomer phone number
responeData.productsjson element-
responeData.products[].uuidstringID is for transactions related to products
responeData.products[].namestringproduct name
responeData.products[].qtyintegernumber of products
responeData.products[].priceintegerproduct price
responeData.paymentjson element-
responeData.payment.uuidstringID is for related payments
responeData.payment.channelstringpayment channel
responeData.payment.codestringcode used for making payments
responeData.payment.payment_refstringReference number for related payment
responeData.payment.paid_amountintegertotal bill
responeData.payment.feeintegeradministrative fee
responeData.payment.nettintegerThe nominal that must be paid

Response Sample

{
"responseCode": "2000300",
"responseMessage": "Invoice Found",
"responseDate": "2022-04-11T15:27:43+07:00",
"responseData": {
"id": "a3ef3f93-7fcb-439a-889e-14976a46492e",
"ref": "01002676201405,201406,201407,201408,201409,201410",
"created_at": "2022-04-11 11:41:45",
"redirect_url": "https://checkout.bmstaging.id/HJHKvf1chmn",
"back_url": "https://your-invoice-url.com",
"status": "PAID",
"customer": {
"name": "PERM. BUMI CITRA FAJ",
"email": "[email protected]",
"phone": "01002676"
},
"products": [
{
"uuid": "0b81e4b1-a1c7-4d96-985f-b24b7ed80b67",
"name": "01002676",
"qty": 1,
"price": "305300"
}
],
"payment": {
"uuid": "6b67178b-0378-4bee-b4ac-87945890ca0f",
"channel": "BSI",
"code": "164965211642",
"payment_ref": "10460",
"paid_amount": "306300",
"fee": "1000",
"nett": "305300",
"created_at": "2022-04-11T04:43:03.000000Z",
"updated_at": "2022-04-11T04:43:03.000000Z"
}
}
}