This endpoint is used to retrieve a single transaction based on it's ID. Call this endpoint for each transaction ID received in the UPDATED_TRANSACTIONS_AVAILABLE webhook to retrieve updated data for the transaction(s) you have already received.
Name Format Description idnumber The ID of the merchant. namestring The name of the merchant.
Name Format Description idstring Knot's ID for the transaction. external_idnullable, string The merchant's ID for the transaction. datetimestring The timestamp of the transaction in UTC. ISO 8601 format. urlnullable, string The URL of the transaction on the merchant's website. order_statusstring The status of the order associated with the transaction.ORDERED, BILLED, SHIPPED, DELIVERED, REFUNDED, CANCELLED, FAILED, COMPLETED, PICKED_UP, UNRECOGNIZED payment_methodsobject An array of payment methods used in the transaction. priceobject The price details of the transaction. productsobject An array of specific products purchased in the transaction.
Name Format Description external_idnullable, string The merchant's ID for the payment method. typestring The type of payment method.CARD, APPLE_PAY, GOOGLE_PAY, AMAZON_PAY, PAYPAL, CASH_APP, VENMO, AFFIRM, KLARNA, GIFT_CARD, CASH, LOYALTY_POINTS, UNRECOGNIZED brandnullable, string The merchant's brand for the payment method. last_fournullable, string The last 4 digits of payment method, if a payment card. namenullable, string The name of the payment method provided by the user. transaction_amountnullable, string The amount of the transaction placed on the payment method ($).
Name Format Description sub_totalnullable, string The subtotal of the transaction ($). totalstring The total of the transaction ($). currencynullable, string The currency used in the transaction. ISO 4217 format. adjustmentsnullable, object An array of adjustments associated with the transaction that resulted in a difference between the sub_total and total.
Name Format Description typestring The type of adjustment.DISCOUNT, TAX, TIP, SHIPPING_FEE, CANCELLATION_FEE, REFUND, UNRECOGNIZED labelnullable, string The merchant's label for the adjustment. amountstring The amount of the adjustment ($).
Name Format Description external_idnullable, string The merchant's ID for the product/SKU. Incredibly rare that this field is null. namestring The name of the product. urlnullable, string The URL of the product on the merchant's website. quantitynullable, number The number of units of the product purchased in the transaction. pricenullable, object The price of the product. eligibilitynullable, list The eligibility of the product."FSA/HSA"
Name Format Description sub_totalnullable, string The subtotal price of the product in the transaction. totalnullable, string The total price of the product in the transaction. unit_pricenullable, string The price of the product per unit.
Field Enum error_typeINVALID_INPUT, INVALID_REQUEST, USER_ERROR, LINKEDMERCHANT_ERRORerror_codeINVALID_API_KEYS, INVALID_FIELD, INVALID_CURSOR_FORMAT, USER_NOT_FOUND, LINKEDMERCHANT_NOT_FOUND
