Use this HTTP request for sending receipt/bill data.
Development / For testing
Send POST request to:
Production
Send POST request to:
Attributes (Request)
ATTRIBUTE NAME | FORMAT | TYPE | ENUM | MAXLENGTH | DESCRIPTION | EXAMPLE |
---|---|---|---|---|---|---|
“vat_number” | “string” | “string” | 50 | “1234567890” | ||
“business_place” | “string” | “string” | 50 | “AABBCC” | ||
“business_device” | “string” | “string” | 50 | “1” | ||
“bill_number” | “int32” | “integer” | “1” | |||
“bill_datetime” | “date-time” | “string” | “Format: ISO8601 YYYY-dd-mmTH:i:s” | “2020-01-01T12:12:12” | ||
“total_value” | “number” | “number” | “105.00” | |||
“tax_free” | “number” | “number” | “Untaxed amount, value can not be higher than total_value”, optional | “0.00” | ||
“payment_type” | “string” | “string” | {“C”, “T”, “K”, “D”, “P”, “O”} | C – cash T – Bank transfer K – credit card D – debit card P – Post payment (credit) O – Other |
||
“security_code” | “string” | “string” | “MD5( secretKey + vat_number + business_place + this->business_device + bill_number + bill_datetime + total_value )” |
|||
“currency_code” | “string” | “string” | {“NGN”, “USD”, “EUR”, “GBP”} | “Optional. NGN by default.” | ||
“client_vat_number” | “string” | “string” | 50 | |||
“rate” | “number” | “number” | “Tax Rate Percentage” | “5.00” | ||
“base_value” | “number” | “number” | “Tax Base Value” | “100.00” | ||
“value” | “number” | “number” | “Tax Value” | “5.00” | ||
“resend” | “number” | “number” | “Value is 0 by default. If the bill was not sent real time and is sent retrospectively then the value should be 1”, optional | “0” |
Attributes (Response)
created_at – date/time of creation in ISO 8601 format (UTC)
payment_code:
- UID (Unique Identifier) signed code from API
- “O” – Other (mixed payments and etc.)
Request example in Chrome ARC:
“bill_ taxes” is used to send VAT.
“bill_tax_gst” is used to send Consumption Tax if it exists within State. This property is optional.
“bill_tax_other” is used to send other taxes if they exist, for example “Luxury tax”. This property is optional.
“bill_tax_gst” is used to send Consumption Tax if it exists within State. This property is optional.
“bill_tax_other” is used to send other taxes if they exist, for example “Luxury tax”. This property is optional.
[…] UID. The value of the “resend” property needs to be 1. For more information visit the documentation page. It is not necessary to print the receipt/bill […]
Getting this error – Invalid business place!
So what would be pass into this parameter
Which value passed in business_place, business_device, bill_number, bill_datetime, total_value, etc. because when I am running this API on dev mode I am getting Invalid business place! error. Please guide me regarding this error.