POST
/
sessions
/
{id}
/
refund
curl -X POST https://api.stableyard.fi/v2/sessions/ses_abc123/refund \
  -H "Authorization: Bearer sy_secret_*" \
  -H "Idempotency-Key: refund-ses-abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500000,
    "reason": "Customer requested partial refund"
  }'

{
  "object": "refund",
  "sessionId": "ses_abc123",
  "amount": 2500000,
  "status": "pending",
  "reason": "Customer requested partial refund",
  "requestId": "req_abc123"
}
Create a refund for a settled session. Supports partial refunds. Auth: sy_secret_*
​
id
string
required
Session ID of the settled session
​
amount
number
required
Refund amount in smallest unit. Minimum: 1. Cannot exceed the original session amount.
​
reason
string
Reason for the refund
curl -X POST https://api.stableyard.fi/v2/sessions/ses_abc123/refund \
  -H "Authorization: Bearer sy_secret_*" \
  -H "Idempotency-Key: refund-ses-abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500000,
    "reason": "Customer requested partial refund"
  }'

{
  "object": "refund",
  "sessionId": "ses_abc123",
  "amount": 2500000,
  "status": "pending",
  "reason": "Customer requested partial refund",
  "requestId": "req_abc123"
}