POST /paymentrequest

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
draft Boolean No

Indicate if request should be saved as draft. Defaults to false and overrides send_notification

split_code String No

The split code of the transaction split.

tax[] Array No

Array of taxes

customer String Yes

Customer id or code

description String No

A short description of the payment request

line_items[] Array No

Array of line items

invoice_number Integer No

Numeric value of invoice. Invoice will start from 1 and auto increment from there. This field is to help override whatever value Paystack decides. Auto increment for subsequent invoices continue from this point.

amount Integer No

Payment request amount. Only useful if line items and tax values are ignored. The endpoint will throw a friendly warning if neither is available.

send_notification Boolean No

Indicates whether Paystack sends an email notification to customer. Defaults to true

currency String No

Specify the currency of the invoice. Allowed values are NGN, GHS, ZAR and USD. Defaults to NGN

has_invoice Boolean No

Set to true to create a draft invoice (adds an auto incrementing invoice number if none is provided) even if there are no line_items or tax passed

due_date String No

ISO 8601 representation of request due date

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.