Accept payments

Refund a payment

Issue a full or partial refund through the provider that processed the payment.

Create the refund

Use a server key with refunds:write. Omit amount for the remaining refundable balance, or supply an integer in minor units for a partial refund. Persist a distinct idempotency key for the refund operation. Provider support and payment state determine whether the refund can be made.

refund.sh

curl https://api.veyqo.org/api/v1/payments/pay_example/refunds \
  -H "Authorization: Bearer $VEYQO_SECRET_KEY" \
  -H "Idempotency-Key: $REFUND_ATTEMPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 25000, "reason": "requested_by_customer" }'

Track the result

Save the returned refund ID and inspect its status. Retrieve it with GET /refunds/{id} using refunds:read. Do not tell the customer a refund is complete until its status confirms completion.