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.
 
 
0 0 votes
Article Rating
Subscribe
Notify of
guest
1 Comment
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
trackback

[…] 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 […]