lightsparkdev · claude · Jun 25, 2026
diff --git a/mintlify/global-p2p/quickstart.mdx b/mintlify/global-p2p/quickstart.mdx
@@ -214,6 +214,7 @@ In this guide, the entities map as follows:
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
     "status": "PROCESSING",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
     "platformCustomerId": "alice_user_id",
     "source": {
@@ -243,6 +244,7 @@ In this guide, the entities map as follows:
       "id": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "sentAmount": { "amount": 10000, "currency": { "code": "USDC", "decimals": 2 } },
       "receivedAmount": { "amount": 168500, "currency": { "code": "MXN", "decimals": 2 } },
       "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",

diff --git a/mintlify/global-p2p/sending-receiving-payments/receiving-payments.mdx b/mintlify/global-p2p/sending-receiving-payments/receiving-payments.mdx
@@ -30,6 +30,7 @@ When someone initiates a payment to one of your users' UMA addresses, you'll rec
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
     "status": "PENDING",
     "type": "INCOMING",
+    "direction": "CREDIT",
     "source": {
       "sourceType": "UMA_ADDRESS",
       "umaAddress": "$mary.sender@thelessgoodbank.com"
@@ -147,6 +148,7 @@ When the payment completes, you'll receive another webhook notifying you of the
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
     "status": "COMPLETED",
     "type": "INCOMING",
+    "direction": "CREDIT",
     "source": {
       "sourceType": "UMA_ADDRESS",
       "umaAddress": "$mary.sender@thelessgoodbank.com"

diff --git a/mintlify/payouts-and-b2b/payment-flow/list-transactions.mdx b/mintlify/payouts-and-b2b/payment-flow/list-transactions.mdx
@@ -20,6 +20,7 @@ curl -X GET 'https://api.lightspark.com/grid/2025-10-13/transactions' \
       "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "source": {
         "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
         "currency": "USD"

diff --git a/mintlify/payouts-and-b2b/payment-flow/send-payment.mdx b/mintlify/payouts-and-b2b/payment-flow/send-payment.mdx
@@ -91,6 +91,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/transfer-out' \
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000015",
   "status": "PENDING",
   "type": "OUTGOING",
+  "direction": "DEBIT",
   "source": {
     "accountId": "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
     "currency": "USD"
@@ -141,6 +142,7 @@ You'll receive `OUTGOING_PAYMENT.<STATUS>` webhooks as the transaction progresse
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000015",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": { "amount": 12550, "currency": { "code": "USD", "decimals": 2 } },
     "receivedAmount": { "amount": 12550, "currency": { "code": "USD", "decimals": 2 } },
     "settledAt": "2025-10-03T15:02:30Z"
@@ -323,6 +325,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes/Quote:019542f5-b
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 10000,
       "currency": { "code": "USD", "symbol": "$", "decimals": 2 }

diff --git a/mintlify/payouts-and-b2b/quickstart.mdx b/mintlify/payouts-and-b2b/quickstart.mdx
@@ -210,6 +210,7 @@ During the funding process, you'll receive transaction status update webhooks.
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000010",
     "status": "COMPLETED",
     "type": "INCOMING",
+    "direction": "CREDIT",
     "receivedAmount": {
       "amount": 100000,
       "currency": {
@@ -419,6 +420,7 @@ The quote status changes to `PROCESSING` and the transfer is initiated. You'll r
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000015",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 50000,
       "currency": {

diff --git a/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx b/mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx
@@ -94,7 +94,8 @@ POST /transfer-out
 {
   "id": "Transaction:...",
   "status": "PENDING",
-  "type": "OUTGOING"
+  "type": "OUTGOING",
+  "direction": "DEBIT"
 }
 ```
 
@@ -170,6 +171,7 @@ When a payment fails or is cancelled, refunds are tracked in a dedicated object
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
   "status": "FAILED",
   "type": "OUTGOING",
+  "direction": "DEBIT",
   "failureReason": "QUOTE_EXECUTION_FAILED",
   "refund": {
     "reference": "UMA-Q12345-REFUND",
@@ -209,6 +211,7 @@ Outgoing payment webhooks use the format `OUTGOING_PAYMENT.<STATUS>`. The webhoo
     "id": "Transaction:...",
     "status": "PENDING",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {"amount": 100000, "currency": {"code": "USD"}},
     "receivedAmount": {"amount": 92000, "currency": {"code": "EUR"}},
     "createdAt": "2025-10-03T15:00:00Z"
@@ -374,6 +377,7 @@ GET /transactions?customerId=Customer:abc123&startDate=2025-10-01T00:00:00Z&limi
       "id": "Transaction:...",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "sentAmount": {"amount": 100000, "currency": {"code": "USD"}},
       "receivedAmount": {"amount": 92000, "currency": {"code": "EUR"}},
       "settledAt": "2025-10-03T15:05:00Z"

diff --git a/mintlify/ramps/platform-tools/sandbox-testing.mdx b/mintlify/ramps/platform-tools/sandbox-testing.mdx
@@ -157,6 +157,7 @@ Within seconds, you'll receive a webhook notification confirming the on-ramp com
     "id": "Transaction:sandbox025",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 10000,
       "currency": { "code": "USD" }

diff --git a/mintlify/ramps/platform-tools/webhooks.mdx b/mintlify/ramps/platform-tools/webhooks.mdx
@@ -26,6 +26,7 @@ Grid sends webhooks for key events in the ramp lifecycle:
       "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "sentAmount": {
         "amount": 10000,
         "currency": { "code": "USD", "decimals": 2 }

diff --git a/mintlify/ramps/quickstart.mdx b/mintlify/ramps/quickstart.mdx
@@ -218,6 +218,7 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/sandbox/send" \
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
   "status": "PROCESSING",
   "type": "OUTGOING",
+  "direction": "DEBIT",
   "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
   "platformCustomerId": "customer_12345",
   "source": {
@@ -261,6 +262,7 @@ Once Grid receives your payment and completes the USD-to-BTC conversion and deli
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 10000,
       "currency": {

diff --git a/mintlify/rewards/developer-guides/distributing-rewards.mdx b/mintlify/rewards/developer-guides/distributing-rewards.mdx
@@ -259,6 +259,7 @@ When the Bitcoin transfer completes, you'll receive a webhook:
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 100,
       "currency": { "code": "USD" }

diff --git a/mintlify/rewards/developer-guides/listing-transactions.mdx b/mintlify/rewards/developer-guides/listing-transactions.mdx
@@ -23,6 +23,7 @@ curl -X GET 'https://api.lightspark.com/grid/2025-10-13/transactions' \
       "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "source": {
         "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
         "currency": "USD"

diff --git a/mintlify/rewards/quickstart.mdx b/mintlify/rewards/quickstart.mdx
@@ -314,6 +314,7 @@ When the Bitcoin transfer completes, you'll receive a webhook notification:
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000025",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": {
       "amount": 100,
       "currency": {

diff --git a/mintlify/snippets/error-handling.mdx b/mintlify/snippets/error-handling.mdx
@@ -136,6 +136,7 @@ When a transaction fails, the `failureReason` field provides specific details:
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
   "status": "FAILED",
   "type": "OUTGOING",
+  "direction": "DEBIT",
   "failureReason": "QUOTE_EXECUTION_FAILED"
 }
 ```
@@ -153,6 +154,7 @@ When a transaction fails, the `failureReason` field provides specific details:
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
   "status": "FAILED",
   "type": "INCOMING",
+  "direction": "CREDIT",
   "failureReason": "PAYMENT_APPROVAL_TIMED_OUT"
 }
 ```

diff --git a/mintlify/snippets/reconciliation/reconciliation.mdx b/mintlify/snippets/reconciliation/reconciliation.mdx
@@ -34,6 +34,7 @@ Sample webhook payload:
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "source": {
       "sourceType": "ACCOUNT",
       "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
@@ -90,6 +91,7 @@ Response
       "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
       "status": "COMPLETED",
       "type": "OUTGOING",
+      "direction": "DEBIT",
       "source": {
         "sourceType": "ACCOUNT",
         "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"

diff --git a/mintlify/snippets/sending/cross-currency.mdx b/mintlify/snippets/sending/cross-currency.mdx
@@ -149,6 +149,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes/Quote:019542f5-b
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": { "amount": 10000, "currency": { "code": "USD", "decimals": 2 } },
     "receivedAmount": { "amount": 9200, "currency": { "code": "EUR", "decimals": 2 } },
     "exchangeRate": 0.92,
@@ -277,6 +278,7 @@ Grid automatically detects blockchain deposits and processes the transfer once f
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000030",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": { "amount": 10000, "currency": { "code": "USDC", "decimals": 2 } },
     "receivedAmount": { "amount": 9200, "currency": { "code": "EUR", "decimals": 2 } },
     "exchangeRate": 0.92,

diff --git a/mintlify/snippets/sending/same-currency.mdx b/mintlify/snippets/sending/same-currency.mdx
@@ -46,6 +46,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/transfer-out' \
   "id": "Transaction:019542f5-b3e7-1d02-0000-000000000015",
   "status": "PENDING",
   "type": "OUTGOING",
+  "direction": "DEBIT",
   "source": {
     "sourceType": "ACCOUNT",
     "accountId": "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"
@@ -78,6 +79,7 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/transfer-out' \
     "id": "Transaction:019542f5-b3e7-1d02-0000-000000000015",
     "status": "COMPLETED",
     "type": "OUTGOING",
+    "direction": "DEBIT",
     "sentAmount": { "amount": 12550, "currency": { "code": "USD", "decimals": 2 } },
     "receivedAmount": { "amount": 12550, "currency": { "code": "USD", "decimals": 2 } },
     "settledAt": "2025-10-03T15:02:30Z"