Sign in

v1

latestOpenAPI 3.0.02026-07-24126202516.7 KB
Items

Update Item

Update an existing Items attributes using a given :id. Note: An item can only be updated if it's in pending state. Once an item has begun a payment process, you cannot update it.

patch/items/{id}

Path parameters

idstring required

Item ID

Request body

amountinteger

The cost in cents

namestring

A name for the item

buyer_idstring

Marketplace / Pltform buyer ID

seller_idstring

Marketplace / Platform Seller ID

descriptionstring

A description of the item

custom_descriptorstring

When custom_descriptors are enabled, this is the information to appear on credit card and direct debit statements.

Example request

{
  "name": "Item 7190770-1-2908",
  "buyer_id": "buyer-719013950014",
  "seller_id": "seller-71718579",
  "description": "Test Item 7190770-1-2908"
}

Response

OK

Example response

{
  "items": {
    "id": "7190770-1-2908",
    "name": "Item #001",
    "description": "My first Item.",
    "state": "pending",
    "status": 22000,
    "amount": 20000,
    "payment_type_id": 2,
    "currency": "AUD",
    "buyer_name": "Sample Buyer",
    "buyer_email": "sample.buyer@assemblypayments.com",
    "buyer_country": "AUS",
    "seller_name": "Sample Seller",
    "seller_email": "sample.seller@assemblypayments.com",
    "seller_country": "AUS",
    "tds_check_state": "NA",
    "net_amount": 20000,
    "seller_fees": 400,
    "promisepay_fee": 350,
    "total_outstanding": 20000,
    "total_amount": 20000,
    "payment_method": "pending",
    "payment_credit_card_enabled": true,
    "payment_direct_debit_enabled": true,
    "related": {
      "buyers": "064d6800-fff3-11e5-86aa-5e5517507c66",
      "sellers": "5830def0-ffe8-11e5-86aa-5e5517507c66"
    }
  }
}