Skip to main content
GET
https://api.alguna.io
/
refunds
/
{id}
curl https://api.alguna.io/refunds/ref_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "ref_abc123",
  "amount": "99.00",
  "status": "succeeded",
  "currency": "USD",
  "accountId": "acc_xyz789",
  "paymentId": "pay_def456",
  "reason": "Customer requested refund",
  "failureReason": null,
  "processorId": "re_stripe_123",
  "externalId": "re_1234567890",
  "externalUrl": "https://dashboard.stripe.com/refunds/re_1234567890",
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-20T10:05:00Z"
}
Retrieve a refund by its ID.
​
id
string
required
The refund ID.
curl https://api.alguna.io/refunds/ref_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "ref_abc123",
  "amount": "99.00",
  "status": "succeeded",
  "currency": "USD",
  "accountId": "acc_xyz789",
  "paymentId": "pay_def456",
  "reason": "Customer requested refund",
  "failureReason": null,
  "processorId": "re_stripe_123",
  "externalId": "re_1234567890",
  "externalUrl": "https://dashboard.stripe.com/refunds/re_1234567890",
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-20T10:05:00Z"
}
​
id
string
Unique identifier for the refund.
​
amount
string
Refund amount as a decimal string.
​
status
string
Refund status: pending, processing, succeeded, failed, or canceled.
​
currency
string
Currency code.
​
accountId
string
The account that received the refund.
​
paymentId
string
The original payment that was refunded.
​
reason
string
Reason for the refund.
​
failureReason
string
Reason for failure if status is failed.
​
processorId
string
Payment processor’s internal refund ID.
​
externalId
string
External reference ID from the payment processor.
​
externalUrl
string
Link to view the refund in the payment processor’s dashboard.
​
createdAt
string
ISO 8601 timestamp of creation.
​
updatedAt
string
ISO 8601 timestamp of last update.