---
title: "Create an Invoice Return"
method: POST
path: "/invoicereturn"
---

# Create an Invoice Return

`POST /invoicereturn`

Use this route to retrieve a receipt by Id

## Query parameters

- `id` integer, required
- `echo` boolean

## Request body

- object
  - `merchantId` integer, required
  - `type` string
  - `totalAmount` string
  - `subTotalAmount` string
  - `discountAmount` string
  - `balance` string
  - `paidAmount` string
  - `payments` object[]
    - `merchantId` integer
    - `tenderType` string
    - `amount` number, float
    - `type` string
    - `paymentToken` string

## Response `201`

201

- object
  - `id` integer
  - `merchantId` integer
  - `invoiceId` integer
  - `reference` string
  - `created` string
  - `modified` string
  - `subtotalAmount` string
  - `discountAmount` string
  - `totalAmount` string
  - `lineItemCount` integer
  - `balance` string
  - `lineItems` object[]
  - `shippingLineItems` object[]
  - `discounts` object[]
  - `payments` object[]
    - `created` string
    - `paymentToken` string
    - `originalId` integer
    - `id` integer
    - `creatorName` string
    - `isDuplicate` boolean
    - `merchantId` integer
    - `batch` string
    - `batchId` integer
    - `tenderType` string
    - `currency` string
    - `amount` string
    - `cardAccount` object
      - `cardType` string
      - `entryMode` string
      - `last4` string
      - `token` string
      - `expiryMonth` string
      - `expiryYear` string
      - `hasContract` boolean
      - `cardPresent` boolean
    - `authOnly` boolean
    - `status` string
    - `risk` object
    - `requireSignature` boolean
    - `settledAmount` string
    - `settledCurrency` string
    - `cardPresent` boolean
    - `authMessage` string
    - `availableAuthAmount` string
    - `reference` string
    - `invoice` string
    - `customerName` string
    - `type` string
    - `shouldGetCreditCardLevel` boolean
  - `taxes` object[]
  - `adjustmentAmount` string

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)