---
title: "Create a Payment from a Payment Intent"
method: POST
path: "/payments"
tags: ["Payments"]
---

# Create a Payment from a Payment Intent

`POST /payments`

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string
- `Idempotency-Key` string

## Request body

- union
  - object
    - `paymentIntent` union
      - PaymentIntentId
        - `id` string, uuid, required
      - CreatePaymentIntentRequestPayload
        - `targetAmount` AmountDetails — Amount that will be credited to Recipient
          - `value` number, required — Value of the currency between 1 and 99999999.99
          - `currency` 'USD', required — Currency value
        - `paymentMethod` PaymentMethodId, required
          - `id` string, uuid, required
        - `recipient` RecipientId, required
          - `id` string, uuid, required
        - `payer` PayerId, required
          - `id` string, uuid, required
        - `details` PaymentDetails
          - `accountName` string — The name of the account. Used by the receiving entity for reconciling payments.
          - `accountNumber` string — The invoice or account number. Used by the receiving entity for reconciling payments.
          - `memo` string — Short description of the payment. Used by the receiving entity for reconciling payments.
          - `disbursementInformation` object — The disbursement bank account or originator account for the payment.
            - `accountLastFour` string — Last four digits of the disbursement bank account number
            - `routingNumber` string — Routing number for the disbursement bank account
            - `bankName` string — Name of the bank for the disbursement account
          - `traceInformation` object — The trace information for locating the payment.
            - `reference` string — Number or ID of the trace information.
        - `feeAmendments` object — Fee override of the fee rate charged on a single transaction
          - `PLASTIQ_SERVICE_FEE` FeeAmendmentDetails — Fee override details indicating the rate or price and a note
            - `rate` string — The rate of the fee to apply, expressed as a percentage.
        - `metadata` PaymentMetadata — additional payment information to support operational requirements
        - `isExpedited` boolean — Used to expedite a payment's delivery. If `true`, the delivery date will be set to the fastest available.
    - `payer` PayerId
      - `id` string, uuid, required
  - object
    - `targetAmount` AmountDetails — Amount that will be credited to Recipient
      - `value` number, required — Value of the currency between 1 and 99999999.99
      - `currency` 'USD', required — Currency value
    - `paymentMethod` PaymentMethodId, required
      - `id` string, uuid, required
    - `recipient` RecipientId, required
      - `id` string, uuid, required
    - `payer` PayerId, required
      - `id` string, uuid, required
    - `details` PaymentDetails
      - `accountName` string — The name of the account. Used by the receiving entity for reconciling payments.
      - `accountNumber` string — The invoice or account number. Used by the receiving entity for reconciling payments.
      - `memo` string — Short description of the payment. Used by the receiving entity for reconciling payments.
      - `disbursementInformation` object — The disbursement bank account or originator account for the payment.
        - `accountLastFour` string — Last four digits of the disbursement bank account number
        - `routingNumber` string — Routing number for the disbursement bank account
        - `bankName` string — Name of the bank for the disbursement account
      - `traceInformation` object — The trace information for locating the payment.
        - `reference` string — Number or ID of the trace information.
    - `feeAmendments` object — Fee override of the fee rate charged on a single transaction
      - `PLASTIQ_SERVICE_FEE` FeeAmendmentDetails — Fee override details indicating the rate or price and a note
        - `rate` string — The rate of the fee to apply, expressed as a percentage.
    - `metadata` PaymentMetadata — additional payment information to support operational requirements
    - `isExpedited` boolean — Used to expedite a payment's delivery. If `true`, the delivery date will be set to the fastest available.

## Response `200`

Payment created successfully

- Payment
  - `id` string, uuid
  - `fees` Fee[]
    - `amount` object — Amount that will be credited to Recipient
      - `value` number, required — Value of the currency between 1 and 99999999.99
      - `currency` 'USD', required — Currency value
    - `type` 'PLASTIQ_SERVICE_FEE' | 'PLASTIQ_CROSS_BORDER_FEE' | 'DELIVERY_FEE' | 'EXPEDITED_PROCESSING_FEE' | 'EXPEDITED_HANDLING_FEE' — The type of fee applied to the payment
    - `rate` string — The rate of the fee assessed, presented in percentage.
  - `sourceAmount` object — Amount that will be credited to Recipient
    - `value` number, required — Value of the currency between 1 and 99999999.99
    - `currency` 'USD', required — Currency value
  - `targetAmount` object — Amount that will be credited to Recipient
    - `value` number, required — Value of the currency between 1 and 99999999.99
    - `currency` 'USD', required — Currency value
  - `paymentMethod` PaymentMethodId
    - `id` string, uuid, required
  - `recipient` RecipientId
    - `id` string, uuid, required
  - `payer` PayerId
    - `id` string, uuid, required
  - `details` PaymentDetails
    - `accountName` string — The name of the account. Used by the receiving entity for reconciling payments.
    - `accountNumber` string — The invoice or account number. Used by the receiving entity for reconciling payments.
    - `memo` string — Short description of the payment. Used by the receiving entity for reconciling payments.
    - `disbursementInformation` object — The disbursement bank account or originator account for the payment.
      - `accountLastFour` string — Last four digits of the disbursement bank account number
      - `routingNumber` string — Routing number for the disbursement bank account
      - `bankName` string — Name of the bank for the disbursement account
    - `traceInformation` object — The trace information for locating the payment.
      - `reference` string — Number or ID of the trace information.
  - `deliveryDate` string, date
  - `createdAt` string, date-time
  - `status` 'CHARGED' | 'UNDER_REVIEW' | 'IN_TRANSIT' | 'DEPOSITED' | 'REFUNDED' | 'CARD_DECLINED' | 'NOT_CAPTURED' | 'TRANSIT_EXCEPTION' — The current state of a Payment
  - `statusReasons` StatusReason[]
    - `code` string, required
    - `message` string, required
  - `sourceDescriptor` string
  - `targetDescriptor` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/plastiq/apis/plastiq-public-api.md) · [All operations](https://skmtc.dev/plastiq/apis/plastiq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastiq/plastiq-public-api/revisions/cfd776dd9ac5/schema)