diff --git a/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx b/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx index c9ed40fa..ec786e96 100644 --- a/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx +++ b/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx @@ -357,6 +357,26 @@ In the manual cancellation flow, `OUTGOING_PAYMENT.COMPLETED` fires after the re +## Receipt Delivery Confirmation + +Some platforms are contractually required to send a receipt to their customer after a transaction completes. Use the receipt confirmation endpoint to record when the receipt was delivered: + +```bash +POST /transactions/{transactionId}/confirm + +{ + "receiptDeliveryConfirmedAt": "2025-08-15T14:31:00Z" +} +``` + +**Response:** Returns the updated transaction with `receiptDeliveryConfirmedAt` populated. + +If you omit `receiptDeliveryConfirmedAt` from the request body, Grid uses the current server time. Calling this endpoint again updates the stored confirmation time. + + +This endpoint is only necessary if your platform agreement requires receipt confirmation. Most integrations do not need this step. + + ## Listing Transactions Query all transactions for a customer or date range: