The create payment request resource endpoint creates a loan and reserves the specified order amount. This process is called authorisations. When you authorise, finmid will generate a unique id that you'll use to reference the transaction moving forward.

For creating a new payment request, you need the following things:

  1. Create a new ID for this payment request (we recommend using the invoice number),
  2. Choose repayment term days,
  3. Buyer's ID specified on creation,
  4. Line items (items in the order and seller's ID specified on creation),
  5. Total order amount.
  6. (Optional) Invoice due date, which can be added now, or via the update endpoint.

⚠️

Invoice Number and Line Item Delivery Address(es)

Invoice number is optional upon payment request creation. However, it must be provided prior to capturing the payment request. Invoice number can be provided via the Update Payment Request endpoint,

The sum of all line_item.total_price fields must match the amount provided in the total_amount field.

Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!