Invoices

Suggest Edits

This collection of APIs enables you to generate a digital invoice for your customers or buyers who need to pay money to your business or have already paid you offline (in cash or similar means).

The invoice link once generated can then be sent by you over any digital channel like email, SMS, or Whatsapp to the respective customer/buyer for making their payment via UPI. The same invoice can also be downloaded as a PDF by them or by your business team for processing or storing separately as suitable.

You can also choose to add your own branded sub-domain to the link (URL) of the invoice. For getting that feature, please connect with us at [email protected]

Generate An Invoice

Generate an invoice request for a consumer/business to make the payment into your preferred virtual bank account.

File Format Support

Serial	Name	Price	Qty	Discount
1	Bill for May	2300	2	10
2	Rent for May	8500	1	0

Sample API

curl --location --request POST 'https://in.staging.decentro.tech/v2/payments/invoice/request' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_PAYMENTS_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--form 'invoice_number="invoice_001"' \
--form 'beneficiary_account_number="462515XXXXXXXXXXXX"' \
--form 'due_date="yyyy-mm-dd"' \
--form 'gst_rate="20"' \
--form 'tds_rate="10"' \
--form 'generate_payment_link="1"' \
--form 'payer_name="John Smith"' \
--form 'payer_email="[email protected]"' \
--form 'payer_mobile="9999999999"' \
--form 'payer_address="23, 1st Stage, Indiranagar, Bangalore 560038"' \
--form 'particulars_csv=@"/Users/apple/Downloads/particulars.csv"'

{
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Invoice Generated Successfully.",
  "data": {
    "invoiceNumber": "invoice_001",
    "invoiceUrl": "<invoice_url>",
    "status": "PAYMENT PENDING"
  }
}

Check Invoice Status

Check the real-time payment status for the invoice generated by you.

curl --location --request GET 'https://in.staging.decentro.tech/v2/payments/invoice/invoice_001/status' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_PAYMENTS_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_PROVIDER_SECRET>' \
--header 'Content-Type: application/json'

{
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "PAYMENT SUCCESS",
  "data": {
    "invoiceNumber": "invoice_001",
    "invoiceUrl": "<invoice_url>",
    "status": "PAYMENT SUCCESS"
  }
}

Updated about 2 months ago