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

# Make Payment

`PATCH /items/{id}/make_payment`

## Request

- Base URL: `https://virtserver.swaggerhub.com/AssemblyPlatforms/assembly-async-api/1.0.0`
- URL: `https://virtserver.swaggerhub.com/AssemblyPlatforms/assembly-async-api/1.0.0/items/{id}/make_payment`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://au-0000.sandbox.auth.assemblypay.com/tokens`

This endpoint extends the original `make_payment` API endpoint to allow asynchronous processing. Clients may optionally supply a wait parameter to have the server wait up to 30 seconds for a response from internal business systems. If a response has been received in that time, it is returned immediately. Otherwise status information and links are returned. Calling the status link returns the item response if available, status information otherwise. Clients may also optionally supply a callback URL in URL-encoded format. The path parameters `{item}`, `{account}` and `{uuid}` are supported. If a callback is present, the system POSTs the internal business system response to it.

## Path parameters

- `id` string, required

## Request body

- MakePaymentRequestBody
  - `account_id` string, required: Account id of the bank account/credit card, etc making payment (not user id)
  - `device_id` string: Device Information for the device initiating the payment. This must be provided for card payments.
  - `ip_address` string: IP Information for the device initiating the payment. This must be provided for card payments.
  - `wait` integer: Time in seconds to wait for item response (up to 30). If this value is not provided, it will defaul to 0 and the call will go asynchronously.
  - `callback` string: Address to callback when an internal business system response is received. Path parameters {account} {item} and {uuid} may be used. The value must be URL-encoded. The example value shown here represents the URL https://callback.example.com/assembly/{item}/{account}/{uuid}

## Response `200`

Response body contains the item response received within the supplied wait time. Note that the HTTP response code will reflect the internal system response.

- SingleItem
  - `items` Item
    - `id` string
    - `name` string
    - `description` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `state` 'pending' | 'payment_required' | 'wire_pending' | 'payment_pending' | 'payment_held' | 'payment_authorized' | '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 | 22195 | 22190 | 22200 | 22300 | 22400 | 22410 | 22420 | 22500 | 22575 | 22600 | 22610 | 22650 | 22670 | 22700 | 22800 | 22680
    - `amount` integer
    - `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
    - `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

## Other responses

- `202`: Request accepted: Response contains status information and query/callback link.
- `400`: Missing or invalid item ID or account ID
- `401`: Invalid authentication header
- `409`: Duplicate request conflict
- `503`: The end point handling your request has received an interrupt or terminate signal. Please try again.

---

[API](https://skmtc.dev/hellozai/apis/asynchronous-api.md) - [All operations](https://skmtc.dev/hellozai/apis/asynchronous-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellozai/apis/asynchronous-api/revisions/176b3e2dd89c?raw)