---
title: "Create Invoice"
method: POST
path: "/tsp/pg/portal/pay/paymentInvoiceService"
---

# Create Invoice

`POST /tsp/pg/portal/pay/paymentInvoiceService`

This is your first endpoint! Edit this page to start documenting your API.

## Request body

- object
  - `merchantId` string, required — Merchant Account ID
  - `invoiceNo` string, required — Unique reference number of the merchant for the payment request
  - `chargeAmount` string, required — Total transaction amount
  - `currencyCode` string, required — Transaction Currency
  - `desc` string, required — Note for the transaction
  - `dueDate` string, required — Due date in the format DD/MM/YYYY
  - `emailID` string — User's Email ID. this is a required field if user's mobile number isn't given
  - `mobileNo` string — User's Mobile number. this is a required field if user's Email ID isn't given
  - `chargeHead1` string, required
  - `addlParam1` string
  - `addlParam2` string
  - `aggregatorId` string — The unique ID assigned if using an aggregator. (Conditional parameter)
  - `serviceProviderSplit` object[] — If the invoice is created with Split Settlement instruction, this parameter will hold details for the splits. Indicate the component that needs to be settled to each serviceProvider. This is mandatory Incase of split settlement
    - `serviceProviderID` string, required — For Split Settlement instruction, the Service Provider ID as on boarded in JPSL system. serviceProviderID cannot repeat in the subOrders substructure. This is mandatory Incase of split settlement
    - `amount` string, required — For Split Settlement instruction, split of amount for the service provider. The sum of amount under serviceProviderSplit cannot exceed the original order amount. This is mandatory Incase of split settlement
    - `desc` string, required — For Split Settlement instruction, description of split for the service provider
  - `secureHash` string, required — The digital signature calculated as per the Secure Hash logic. This is mandatory Incase of split settlement
  - `allowedPaymentType ` string — Indicates whether payment can be split or not. This Parameter is Mandatory for Split Payment.
  - `expiryPeriod ` string — Indicates Invoice Expiry period in hours. The invoice expires after this time period (from its creation), and no new operations are allowed after this time. This Parameter is Mandatory for Split Payment and Split Settlement use case

## Response `200`

Successful response

## Other responses

- `4XX` — Invoice already exist

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/versions/55aa41b8482f/schema)