---
title: "Create a payment"
method: POST
path: "/payment/{connection_id}/payment"
tags: ["payment", "payment"]
---

# Create a payment

`POST /payment/{connection_id}/payment`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- PaymentPayment
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `total_amount` number
  - `contact_id` string
  - `payment_method` string
  - `type` 'INVOICE' | 'BILL'
  - `currency` string
  - `notes` string
  - `invoice_id` string
  - `bill_id` string
  - `link_id` string
  - `account_id` string
  - `reference` string
  - `organization_id` string
  - `allocations` PaymentAllocation[] — What this payment was applied to (invoices, bills, credit memos, etc.). Replaces separate invoice/bill payment endpoints.
    - `object_type` 'INVOICE' | 'BILL' | 'CREDITMEMO' | 'VENDORCREDIT' | 'SALESORDER' | 'PURCHASEORDER'
    - `object_id` string
    - `amount` number
    - `currency` string
    - `exchange_rate` number
    - `allocated_at` string, date-time
  - `status` 'SUCCEEDED' | 'PENDING' | 'AUTHORIZED' | 'FAILED' | 'CANCELED'
  - `salesorder_id` string
  - `tender_type` 'CARD' | 'CASH' | 'GIFT_CARD' | 'BANK_TRANSFER' | 'WALLET' | 'CHECK' | 'STORE_CREDIT' | 'BUY_NOW_PAY_LATER' | 'EXTERNAL' | 'OTHER'
  - `tip_amount` number
  - `fee_amount` number
  - `location_id` string
  - `device_id` string
  - `card_brand` string
  - `card_last4` string
  - `raw` object

## Response `200`

Successful

- PaymentPayment
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `total_amount` number
  - `contact_id` string
  - `payment_method` string
  - `type` 'INVOICE' | 'BILL'
  - `currency` string
  - `notes` string
  - `invoice_id` string
  - `bill_id` string
  - `link_id` string
  - `account_id` string
  - `reference` string
  - `organization_id` string
  - `allocations` PaymentAllocation[] — What this payment was applied to (invoices, bills, credit memos, etc.). Replaces separate invoice/bill payment endpoints.
    - `object_type` 'INVOICE' | 'BILL' | 'CREDITMEMO' | 'VENDORCREDIT' | 'SALESORDER' | 'PURCHASEORDER'
    - `object_id` string
    - `amount` number
    - `currency` string
    - `exchange_rate` number
    - `allocated_at` string, date-time
  - `status` 'SUCCEEDED' | 'PENDING' | 'AUTHORIZED' | 'FAILED' | 'CANCELED'
  - `salesorder_id` string
  - `tender_type` 'CARD' | 'CASH' | 'GIFT_CARD' | 'BANK_TRANSFER' | 'WALLET' | 'CHECK' | 'STORE_CREDIT' | 'BUY_NOW_PAY_LATER' | 'EXTERNAL' | 'OTHER'
  - `tip_amount` number
  - `fee_amount` number
  - `location_id` string
  - `device_id` string
  - `card_brand` string
  - `card_last4` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/revisions/6c78736a6d42/schema)