Skip to content

Commit 56edba4

Browse files
authored
fix: updating samples for schema changes (#194)
### TL;DR Updated API request examples for UMA payments to use the new source/destination structure instead of currency codes. ### What changed? - Updated the sandbox testing examples to use the new `source` and `destination` objects instead of `sendingCurrencyCode` and `receivingCurrencyCode` - Updated the UMA payment examples to use the new structure with `sourceType`, `destinationType`, and `umaAddress` fields - Changed `senderUserInfo` to `senderCustomerInfo` in the UMA payment example to reflect the correct parameter name - Removed an unnecessary comment in the payouts quickstart example ### How to test? - Try executing the updated API requests against the sandbox environment - Verify that UMA payments work correctly with the new request structure - Confirm that sender information is properly passed using the `senderCustomerInfo` field ### Why make this change? The API has been updated to use a more structured approach for specifying payment sources and destinations, which provides better clarity and flexibility. This change ensures the documentation reflects the current API design and helps users implement UMA payments correctly.
1 parent a34c23d commit 56edba4

3 files changed

Lines changed: 34 additions & 12 deletions

File tree

mintlify/global-p2p/platform-tools/sandbox-testing.mdx

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,14 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
6868
-H "Content-Type: application/json" \
6969
-d '{
7070
"lookupId": "Lookup:019542f5-b3e7-1d02-0000-000000000009",
71-
"sendingCurrencyCode": "MXN",
72-
"receivingCurrencyCode": "USD",
71+
"source": {
72+
"sourceType": "REALTIME_FUNDING",
73+
"currency": "MXN"
74+
},
75+
"destination": {
76+
"destinationType": "UMA_ADDRESS",
77+
"umaAddress": "$success.usd@sandbox.uma.money"
78+
},
7379
"lockedCurrencySide": "SENDING",
7480
"lockedCurrencyAmount": 10000
7581
}'
@@ -165,8 +171,14 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
165171
-H "Content-Type: application/json" \
166172
-d '{
167173
"lookupId": "Lookup:019542f5-b3e7-1d02-0000-000000000009",
168-
"sendingCurrencyCode": "MXN",
169-
"receivingCurrencyCode": "USD",
174+
"source": {
175+
"sourceType": "REALTIME_FUNDING",
176+
"currency": "MXN"
177+
},
178+
"destination": {
179+
"destinationType": "UMA_ADDRESS",
180+
"umaAddress": "$success.usd@sandbox.uma.money"
181+
},
170182
"lockedCurrencySide": "SENDING",
171183
"lockedCurrencyAmount": 10000
172184
}'

mintlify/payouts-and-b2b/quickstart.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -271,7 +271,6 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
271271
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
272272
-H "Content-Type: application/json" \
273273
-d '{
274-
"lookupId": "LookupRequest:019542f5-b3e7-1d02-0000-000000000009", # ID from the lookup step
275274
"source": {
276275
"sourceType": "ACCOUNT",
277276
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" # USD internal account

mintlify/snippets/sending/uma.mdx

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ curl -X GET "https://api.lightspark.com/grid/2025-10-13/receiver/\$recipient@exa
3434
```
3535
The response includes supported currencies and any required payer information fields.
3636

37-
If the receiver's VASP requires payer data, include it in `senderUserInfo` (applies to either tab).
37+
If the receiver's VASP requires payer data, include it in `senderCustomerInfo` (applies to either tab).
3838
### Create a quote
3939

4040
<CodeGroup>
@@ -44,12 +44,18 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
4444
-H "Content-Type: application/json" \
4545
-d '{
4646
"lookupId": "Lookup:019542f5-b3e7-1d02-0000-000000000009",
47-
"sendingCurrencyCode": "USD",
48-
"receivingCurrencyCode": "EUR",
47+
"source": {
48+
"sourceType": "REALTIME_FUNDING",
49+
"currency": "USD"
50+
},
51+
"destination": {
52+
"destinationType": "UMA_ADDRESS",
53+
"umaAddress": "$recipient@example.com"
54+
},
4955
"lockedCurrencySide": "SENDING",
5056
"lockedCurrencyAmount": 10000,
5157
"description": "Invoice #1234 payment",
52-
"senderUserInfo": { "FULL_NAME": "John Sender", "BIRTH_DATE": "1985-06-15" }
58+
"senderCustomerInfo": { "FULL_NAME": "John Sender", "BIRTH_DATE": "1985-06-15" }
5359
}'
5460
```
5561

@@ -59,9 +65,14 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
5965
-H "Content-Type: application/json" \
6066
-d '{
6167
"lookupId": "Lookup:019542f5-b3e7-1d02-0000-000000000009",
62-
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" },
63-
"sendingCurrencyCode": "USD",
64-
"receivingCurrencyCode": "EUR",
68+
"source": {
69+
"sourceType": "ACCOUNT",
70+
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
71+
},
72+
"destination": {
73+
"destinationType": "UMA_ADDRESS",
74+
"umaAddress": "$recipient@example.com"
75+
},
6576
"lockedCurrencySide": "SENDING",
6677
"lockedCurrencyAmount": 10000,
6778
"description": "UMA payment from prefunded balance"

0 commit comments

Comments
 (0)