---
title: "Authorize Payment"
method: PATCH
path: "/items/{id}/authorize_payment"
tags: ["Item Actions"]
---

# Authorize Payment

`PATCH /items/{id}/authorize_payment`

Where pre-authentication is enabled on a platform, initiates a credit card payment authorization for an item. When an authorization is successful, your platform holds the item amount for capture, but there is no transfer of funds happening. This call is used with the Capture Payment or Void Payment calls.

## Path parameters

- `id` string, required

## Request body

- CardAccountIdRequestBody
  - `account_id` string, required — Card account ID
  - `cvv` string — CVV / CVC
  - `merchant_phone` string — Seller User Phone Number or Mobile number. International number format. Include '+' and no spaces.

## Response `200`

OK

- SingleItem
  - `items` Item
    - `id` string, required
    - `name` string, required
    - `description` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `state` 'pending' | 'payment_required' | 'wire_pending' | 'payment_pending' | 'payment_held' | 'payment_authorized' | 'void_pending' | 'voided' | 'fraud_hold' | 'payment_deposited' | 'work_completed' | 'problem_flagged' | 'problem_resolve_requested' | 'problem_escalated' | 'completed' | 'cancelled' | 'refunded' | 'refund_pending' | 'refund_flagged' | 'off_platform_refunded' | 'partial_completed' | 'partial_paid' | 'off_platform_chargedback'
    - `status` 22000 | 22100 | 22110 | 22150 | 22175 | 22180 | 22185 | 22195 | 22190 | 22200 | 22300 | 22400 | 22410 | 22420 | 22500 | 22575 | 22600 | 22610 | 22650 | 22670 | 22700 | 22800 | 22680
    - `amount` integer, required
    - `payment_type_id` integer
    - `currency` string
    - `buyer_name` string
    - `buyer_email` string, email
    - `buyer_country` string
    - `seller_name` string
    - `seller_email` string, email
    - `seller_country` string, email
    - `tds_check_state` string, email
    - `batch_state` string
    - `invoice_url` string
    - `payout_descriptor` string
    - `remaining_amount` integer
    - `requested_release_amount` integer
    - `custom_descriptor` string
    - `net_amount` integer
    - `chargedback_amount` integer
    - `refunded_amount` integer
    - `released_amount` integer
    - `buyer_fees` integer
    - `seller_fees` integer
    - `credit_card_fee` integer
    - `paypal_fee` integer
    - `seller_url` string
    - `buyer_url` string
    - `direct_debit_fee` integer
    - `due_date` string, date, nullable
    - `pending_release_amount` integer
    - `dynamic_descriptor` string
    - `deposit_reference` string
    - `promisepay_fee` integer
    - `total_outstanding` integer
    - `total_amount` integer
    - `payment_method` string
    - `payment_credit_card_enabled` boolean
    - `payment_direct_debit_enabled` boolean
    - `related` object
      - `buyers` string
      - `sellers` string
    - `links` object
      - `self` string
      - `buyers` string
      - `sellers` string
      - `status` string
      - `fees` string
      - `transactions` string
      - `batch_transactions` string
      - `wire_details` string
      - `bpay_details` string
      - `tds_checks` string

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/revisions/60b528b2e015/schema)