---
title: "Create new receipt job"
method: POST
path: "/receipt_jobs"
tags: ["Receipt Job"]
---

# Create new receipt job

`POST /receipt_jobs`

## Request

- Base URL: `https://tb.paymentfusion.com`
- URL: `https://tb.paymentfusion.com/receipt_jobs`
- Auth: none declared. Required headers: `Authorization`, `Accept`, `Content-Type`

Called by the Independent Software Vendor. Creates a new receipt job.

## Headers

- `Authorization` string, api_id:api_token, required
- `Accept` string, required
- `Content-Type` string, required

## Request body `application/x-www-form-urlencoded`

- union
  - ReceiptJobWithSerialNumber
    - `serial_number` string: The serial number of the terminal.
    - `transaction_ref_num` integer, required: The unique identifier of the transaction on the gateway.
    - `receipt_ref_num` integer, required: The unique identifier of the receipt template on the gateway.
    - `merchant_id` string, required: The merchant identifier that will be used to connect to the gateway. Size range - `1..16`
    - `show_terminal_details` true | false: Set show_terminal_details to true only if displaying extra details about the terminal state is needed.
    - `terminal_text` string: The text that should be displayed on the terminal.
  - ReceiptJobWithClientId
    - `client_id` string, required: The client identifier of the terminal
    - `transaction_ref_num` integer, required: The unique identifier of the transaction on the gateway.
    - `receipt_ref_num` integer, required: The unique identifier of the receipt template on the gateway.
    - `merchant_id` string, required: The merchant identifier that will be used to connect to the gateway. Size range - `1..16`
    - `show_terminal_details` true | false: Set show_terminal_details to true only if displaying extra details about the terminal state is needed.

## Response `200`

Success

- object
  - `v` string: The API version that was used to handle the request.

## Other responses

- `4XX`: Possible errors - 1, 3, 4, 7, 35, 103, 107, 116, 117, 118, 119, 164, 166, 167, 168, 189, 234, 235, 241, 246, 257

---

[API](https://skmtc.dev/bankofamerica/apis/transaction-broker-api.md) - [All operations](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/revisions/6097bc689e41?raw)