curl -X POST https://api.saturn-pay.com/v1/wallet/fund-card \
-H "Authorization: Bearer sk_agt_..." \
-H "Content-Type: application/json" \
-d '{
"amountUsdCents": 1000
}'
const response = await fetch('https://api.saturn-pay.com/v1/wallet/fund-card', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_agt_...',
'Content-Type': 'application/json'
},
body: JSON.stringify({ amountUsdCents: 1000 }) // $10.00
});
const { checkoutUrl } = await response.json();
// Redirect user to checkoutUrl
window.location.href = checkoutUrl;
import requests
response = requests.post(
'https://api.saturn-pay.com/v1/wallet/fund-card',
headers={'Authorization': 'Bearer sk_agt_...'},
json={'amountUsdCents': 2500} # $25.00
)
data = response.json()
print('Complete payment at:', data['checkoutUrl'])
{
"checkoutUrl": "https://checkout.stripe.com/c/pay/cs_live_...",
"sessionId": "cs_live_abc123",
"amountUsdCents": 1000,
"expiresAt": "2024-01-20T16:00:00Z"
}
{
"error": {
"code": "INVALID_AMOUNT",
"message": "Minimum amount is $10.00 (1000 cents)"
}
}
Wallets
Fund via Card
Create a Stripe checkout session to fund wallet with card
POST
/
v1
/
wallet
/
fund-card
curl -X POST https://api.saturn-pay.com/v1/wallet/fund-card \
-H "Authorization: Bearer sk_agt_..." \
-H "Content-Type: application/json" \
-d '{
"amountUsdCents": 1000
}'
const response = await fetch('https://api.saturn-pay.com/v1/wallet/fund-card', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_agt_...',
'Content-Type': 'application/json'
},
body: JSON.stringify({ amountUsdCents: 1000 }) // $10.00
});
const { checkoutUrl } = await response.json();
// Redirect user to checkoutUrl
window.location.href = checkoutUrl;
import requests
response = requests.post(
'https://api.saturn-pay.com/v1/wallet/fund-card',
headers={'Authorization': 'Bearer sk_agt_...'},
json={'amountUsdCents': 2500} # $25.00
)
data = response.json()
print('Complete payment at:', data['checkoutUrl'])
{
"checkoutUrl": "https://checkout.stripe.com/c/pay/cs_live_...",
"sessionId": "cs_live_abc123",
"amountUsdCents": 1000,
"expiresAt": "2024-01-20T16:00:00Z"
}
{
"error": {
"code": "INVALID_AMOUNT",
"message": "Minimum amount is $10.00 (1000 cents)"
}
}
Creates a Stripe checkout session for adding funds via credit/debit card.
Request
number
required
Amount in USD cents to add to wallet. Minimum: 1000 ($10.00)
Response
string
Stripe checkout URL. Redirect the user here to complete payment.
string
Stripe session ID for tracking
number
Amount that will be charged
string
ISO 8601 timestamp when session expires
curl -X POST https://api.saturn-pay.com/v1/wallet/fund-card \
-H "Authorization: Bearer sk_agt_..." \
-H "Content-Type: application/json" \
-d '{
"amountUsdCents": 1000
}'
const response = await fetch('https://api.saturn-pay.com/v1/wallet/fund-card', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_agt_...',
'Content-Type': 'application/json'
},
body: JSON.stringify({ amountUsdCents: 1000 }) // $10.00
});
const { checkoutUrl } = await response.json();
// Redirect user to checkoutUrl
window.location.href = checkoutUrl;
import requests
response = requests.post(
'https://api.saturn-pay.com/v1/wallet/fund-card',
headers={'Authorization': 'Bearer sk_agt_...'},
json={'amountUsdCents': 2500} # $25.00
)
data = response.json()
print('Complete payment at:', data['checkoutUrl'])
{
"checkoutUrl": "https://checkout.stripe.com/c/pay/cs_live_...",
"sessionId": "cs_live_abc123",
"amountUsdCents": 1000,
"expiresAt": "2024-01-20T16:00:00Z"
}
{
"error": {
"code": "INVALID_AMOUNT",
"message": "Minimum amount is $10.00 (1000 cents)"
}
}
Notes
- Minimum amount: $10.00 (1000 cents)
- Session expires after 30 minutes
- Credits are added after successful payment (usually instant)
- Standard card processing fees apply