> ## Documentation Index > Fetch the complete documentation index at: https://agents-docs.lightspark.com/llms.txt > Use this file to discover all available pages before exploring further. # Receipts > Send a compliant receipt to your customer for every completed transaction If you're an **unregulated platform** moving funds using Grid's money transmitter licenses, Grid (operating as Lightspark Payments, LLC) is the licensed money transmitter on your transactions. That license requires a receipt to be delivered to the customer for every completed transaction. Because you own the customer relationship, at the end of each transaction you'll need to deliver the transaction receipt. This guide explains when to send a receipt, what it must contain, how to map Grid transaction data to each receipt field, and how to confirm delivery back to Grid. > [!WARNING] > > Receipts are **required for regulatory compliance** — they're not an optional best practice. Send a receipt to your customer for **every** completed transaction, and confirm delivery to Grid. Your platform agreement obligates you to deliver receipts and to furnish records of delivery on request. ## Sample receipt layout Your receipt's visual design is up to you, but the content and field set are fixed. The layout below shows an example with sample data filled in: Your Logo Completed 06 / 10 / 2026 14:32:08 PDT Total charged \$502.50 USD Total received 500.00 USDC Sender Marcus Chen Recipient Sofía Herrera Transaction ID 019542f5-b3e7-1d02-0000-000000000030 On-chain details Transaction Hash 0x8f3a4c2e91b07d6f5a8e2c4b9d1f0a73e6c5b8d2f4a1e9c7b3d0f6a2e8c4b1d9 VC Address(es) From  0x6A2e8C4b1D9f3A4c2E91b07d6F5a8E2c4B9d1F0a To      0x4B9d1F0a73E6c5B8d2F4a1E9c7b3D0f6A2e8C4b1 Amounts Total \$502.50 Exchange Rate 1 USDC = 1.00 USD To report fraud or suspected fraud in connection with the money transmission services, please call customer service toll-free at (855) 516-0103. Refund Policy You may cancel for a full refund within 30 minutes of payment, unless the funds have already been picked up or deposited. See the [refund policy](https://support.lightspark.com/hc/en-us/categories/51347651720859-Cards) or call the number above. Recipient may receive less than the total to recipient due to fees charged by the recipient's bank and any foreign taxes. *(Foreign remittance only.)* Lightspark Payments, LLC  ·  NMLS ID 2429193 8605 Santa Monica Blvd, PMB 64461, West Hollywood, CA 90069 [www.lightspark.com](http://www.lightspark.com)  ·  (855) 516-0103 ## When to send a receipt Trigger receipt generation off the transaction completion event: * **`OUTGOING_PAYMENT.COMPLETED`** — a send (the customer is the sender). * **`INCOMING_PAYMENT.COMPLETED`** — a receive (the customer is the recipient). Send the receipt to your customer as soon as the transaction completes — by email, in-app notification, or any channel that lets the customer **retain** the receipt (for example, a downloadable PDF or an email they can save). > [!NOTE] > > Only completed transactions get a receipt. Transactions that end in `FAILED` or `EXPIRED` do not. Once you send a receipt, **freeze its contents** — if the transaction is later reversed or refunded, the original receipt stays as issued and the reversal is tracked separately on the transaction record. ## What a receipt must contain A compliant receipt combines **Lightspark's regulatory disclosures** (fixed values and legal language) with **data-driven fields** populated from the specific transaction. ### Lightspark regulatory disclosures Include these exactly as written on every receipt: | Field | Value | | - | - | | Money transmitter | Lightspark Payments, LLC | | NMLS ID | 2429193 | | Regulatory address | 8605 Santa Monica Blvd, PMB 64461, West Hollywood, CA 90069 | | Website | [www.lightspark.com](http://www.lightspark.com) | | Customer service phone | (855) 516-0103 | | Fraud reporting | "To report fraud or suspected fraud in connection with the money transmission services, please call customer services toll-free at (855) 516-0103." | | Refund policy | Link to Lightspark's refund policy: [https://support.lightspark.com/hc/en-us/categories/51347651720859-Cards](https://support.lightspark.com/hc/en-us/categories/51347651720859-Cards) | ### Transaction fields | Field | Description | Required when | | - | - | - | | Sender | Name of the customer initiating the transaction | Always | | Recipient | Name of the recipient receiving funds | Always | | Transaction ID | Unique ID per transaction | Always | | Transaction type | Cross-border send/receive, on-ramp, off-ramp, or transfer out; for virtual currency transactions, the currency type | Always | | Transaction date | Date the transaction was funded | Always | | Transaction time | Precise time including time zone | Always | | Transfer amount | Amount in the currency the transmission was funded in | Always | | Total to recipient | Amount in the currency the recipient receives | Always | | Total transfer fees | All fees charged in connection with the transaction | Always | | Taxes | Itemized taxes | When taxes apply | | Total | Total cost to the sender | Always | | Exchange rate | FX rate applied, rounded to 2–4 decimal places | When the funding and receiving currencies differ | | Transaction hash | On-chain transaction hash | Crypto transactions only | | Virtual currency address(es) | Public on-chain addresses involved | Crypto transactions only | | FX shortfall disclosure | "Recipient may receive less due to fees charged by the recipient's bank and foreign taxes." | Foreign remittance transactions only | ## Mapping Grid data to receipt fields Most receipt fields come directly from the [transaction object](https://agents-docs.lightspark.com/api-reference/transactions/get-transaction-by-id.md) — available on the completion webhook payload or by retrieving the transaction. All amounts are integers in the smallest unit of their currency (for example, cents), so format them using the currency's `decimals`. | Receipt field | Grid source | | - | - | | Transaction ID | `id` | | Transaction type | `type` (`OUTGOING` / `INCOMING`) plus the funding currency | | Transaction date / time | `settledAt` | | Sender | `customerId` / `platformCustomerId` (outgoing) or `counterpartyInformation` (incoming) | | Recipient | Destination external account beneficiary — resolve `destination.accountId` to the external account and use its beneficiary (from `accountInfo`) or `customerId` (outgoing); `customerId` / `platformCustomerId` (incoming) | | Transfer amount | `sentAmount.amount` + `sentAmount.currency` | | Total to recipient | `receivedAmount.amount` + `receivedAmount.currency` | | Total transfer fees | `fees` (smallest unit of the sending currency) | | Exchange rate | `exchangeRate` | | Transaction hash | `source.railDetails` / `destination.railDetails` (`transactionHash` + `network`) when that side's `paymentRail` is `ONCHAIN`; `reconciliationInstructions.transactionHash` carries the internal UMA settlement-leg hash | | VC address(es) | Resolve `destination.accountId` to the external account and read the wallet address from its `accountInfo` | ## Example: send a receipt on completion Listen for the completion webhook, verify its signature, assemble the receipt fields, and send the receipt to your customer. See [Webhooks](https://agents-docs.lightspark.com/payouts-and-b2b/platform-tools/webhooks.md) for signature verification. ```javascript theme={null} // Inside your verified webhook handler app.post('/webhooks/grid', async (req, res) => { // ... verify the X-Grid-Signature header first (see Webhooks) ... const event = req.body; if (event.type === 'OUTGOING_PAYMENT.COMPLETED' || event.type === 'INCOMING_PAYMENT.COMPLETED') { const tx = event.data; const format = (money) => (money.amount / 10 ** money.currency.decimals).toFixed(money.currency.decimals); const receipt = { // Lightspark regulatory disclosures (fixed) moneyTransmitter: 'Lightspark Payments, LLC', nmlsId: '2429193', address: '8605 Santa Monica Blvd, PMB 64461, West Hollywood, CA 90069', customerServicePhone: '(855) 516-0103', // Transaction fields transactionId: tx.id, transactionType: tx.type, transactionDateTime: tx.settledAt, transferAmount: `${tx.sentAmount.currency.symbol}${format(tx.sentAmount)}`, totalToRecipient: `${tx.receivedAmount.currency.symbol}${format(tx.receivedAmount)}`, totalTransferFees: tx.fees, exchangeRate: tx.exchangeRate, // include when currencies differ }; await sendReceiptEmail(tx.platformCustomerId, receipt); // your delivery channel // Tell Grid the receipt was delivered await confirmReceiptDelivery(tx.id); } res.status(200).json({ received: true }); }); ``` ## Confirm delivery to Grid After you deliver the receipt to your customer, confirm it with the [Confirm receipt delivery](https://agents-docs.lightspark.com/api-reference/transactions/confirm-receipt-delivery.md) endpoint. Grid stores the confirmation timestamp on the transaction's `receiptDeliveryConfirmedAt` field so it can be furnished to regulators on request. ```bash cURL theme={null} curl -X POST 'https://api.lightspark.com/grid/2025-10-13/transactions/{transactionId}/confirm' \ -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ -H 'Content-Type: application/json' \ -d '{ "receiptDeliveryConfirmedAt": "2025-10-03T15:31:00Z" }' ``` > [!NOTE] > > `receiptDeliveryConfirmedAt` is optional — if you omit it, Grid records the current server time. Calling the endpoint again for the same transaction updates the stored confirmation time. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.