---
title: "Merchant:AddInvoice"
method: POST
path: "/v8/Alliance/addInvoice/json"
tags: ["Invoicing"]
---

# Merchant:AddInvoice

`POST /v8/Alliance/addInvoice/json`

Use this endpoint to add an invoice for a merchant. This invoice can contain platform and transaction costs that you want to invoice to your sub-merchant. The invoice amount will be deducted from the balance of the sub-merchant and will be added to your balance.

## Request body

- object
  - `serviceId` string, required — The serviceId of the partner (alliance) on which the payment should be booked.
  - `merchantId` string, required — The merchantId of the (sub)merchant to invoice.
  - `invoiceId` string, required — The ID of your invoice.
  - `amount` integer, required — The amount in cents.
  - `description` string, required — The payment description.
  - `invoiceUrl` string — A URL pointing to the location of the invoice.
  - `makeYesterday` boolean — Whether the transaction should be backdated to yesterday 23:59:59.
  - `extra1` string — The first free value.
  - `extra2` string — The second free value.
  - `extra3` string — The third free value.
  - `merchantServiceId` string — The service ID of the (sub)merchant to invoice.

## Response `200`

Invoice creation result

- object
  - `request` object
    - `result` '0' | '1'
    - `errorId` string
    - `errorMessage` string
  - `referenceId` string

---

[API](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/versions/2bc260c7bdfc/schema)