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.