Skip to main content

Send transaction information with the Transaction API

Learn how to use the Transaction API to send point of sale transaction information to Instacart. For more information, see Transaction API.

Best Practice

Send transaction information within 10 minutes of finalizing the transaction to ensure seamless reconciliation and timely payments.

Before you begin​

You need the following items:

  • You have a valid client access token
  • You have the base URL of your assigned Instacart development server
  • Store locations are defined in your development environment
  • Catalog items are defined in your development environment

Send the point of sale transaction information​

Send the point of sale transaction information within 10 minutes of finalizing the transaction.

curl --request POST \
 --url 'https://<instacart_development_domain>/v2/retailer_transaction/pos_transactions' \
 --header 'Accept: application/json' \
 --header 'Authorization: Bearer <token>' \
 --header 'Content-Type: application/json' \
 --data '{
  "bin": "546683",
  "last_four": "9929",
  "transaction_timestamp": "2022-09-12T17:34:00Z",
  "id": "12_0200_0036_4e45e940-9bf2-4bf0-bf98-ee8a40540ac3",
  "store_id": "12",
  "sub_total": 99.0,
  "total": 100.22,
  "currency_code": "USD",
    "total_tax": 1.22,
  "cardholder_name": "string",
  "tenders": [
    {
      "type": "CREDIT_CARD",
      "amount": 100.22,
      "approval_processed_by_code": "RETAILER"
    }
  ],
  "items": [
    {
    "line_item_number": "1",
    "bar_code": "7789048811",
    "retailer_reference_code": "48811",
    "description": "string",
    "category": "string",
    "price_per_unit": 0.05,
    "item_price": 0.05,
    "quantity": 1
    }
  ],
  "taxes": [
    {
    "type": "OTHER",
    "type_other": "TotalTaxes",
    "amount": 1.22
    }
  ]
}'

The response contains the transaction ID.

{
  "id": "transaction-id-123"
}

After the transaction information is sent​

After you send your transaction information, the Instacart system ingests, validates, and processes the data. The data might be used for audit, reconciliation, and fraud detection purposes. For more information, see Reconciliation.

Last updated on