---
title: "Create a partner invoice"
method: POST
path: "/partnerinvoices"
---

# Create a partner invoice

`POST /partnerinvoices`

## Request

- Base URL: `https://api-sandbox.ezypay.com/v2`
- URL: `https://api-sandbox.ezypay.com/v2/partnerinvoices`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://identity-sandbox.ezypay.com/token`

A partner invoice is issued by a partner merchant to collect payment from another merchant.Partner invoices provide a full breakdown of the individual invoice items in detail.Invoices can be automatically generated from partner subscriptions at each billing cycle or issued as an ad-hoc, on-demand invoice. Before creating a partner invoice, you must have a merchant connection with the merchant that will receive the partner invoice.

## Request body

- object
  - `issuerMerchantId` string, required: Auto-generated identifier of the merchant who will issue the partner invoice.
  - `recipientMerchantId` string, required: Auto-generated identifier of the merchant will receive the partner invoice and make payment.
  - `memo` string: Brief description of the partner invoice. Max of 100 characters.
  - `items` object[], required: Details of the individual items that are included in the invoice
    - `description` string, required: Description of the invoice item
    - `amount` object: Gross amount due for this invoice item, inclusive of tax.
      - `currency` string, required: Three letter ISO 4217 currency code for the amount.
      - `value` number, double, required: The value of the amount. Must be positive value greater than zero.
      - `type` string: The type of the amount value. Supported values are: `percentage`, `fixed_amount`
    - `tax` object: Tax rate applied to this invoice item. If left blank, uses the tax specified in the merchant settings by default.
      - `rate` number, double: Rate of the specified tax in percentage. Supported values are from 0 to 99.99.
    - `accountingCode` string: Specify an accounting code to categorise revenue collected from the invoice item. Max of 50 characters.

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `924be4030f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ezypay/apis/vault/changes/partnerinvoices/post.md)

---

[API](https://skmtc.dev/ezypay/apis/vault.md) - [All operations](https://skmtc.dev/ezypay/apis/vault/llms.txt) - [OpenAPI document](https://skmtc.dev/ezypay/apis/vault/revisions/924be4030f56?raw)