Create Refund

Refunds a completed deposit back through the provider it was made with, full or partial. The customer's wallet is debited — if the balance is insufficient the refund fails rather than going negative.

Body

customerId

*String

Customer ID whose deposit to refund.

reference

*String

Reference of the original completed deposit (cdep_…).

amount

Number

Amount to refund in major units. Omit to refund the full remaining un-refunded amount.

reason

String

Optional reason for the refund.

POST

/ v2/wallet/refunds

Endpoint URL(TEXT)

https://api.sandbox.switch.tulupay.com/v2/wallet/refunds

https://api.sandbox.switch.tulupay.com/v2/wallet/refunds

Request Body

{
  "customerId": "cus_ada",
  "reference": "cdep_1721375800000_abc123",
  "amount": 1500,
  "reason": "Partial cancellation"
}

{
  "customerId": "cus_ada",
  "reference": "cdep_1721375800000_abc123",
  "amount": 1500,
  "reason": "Partial cancellation"
}

Response(JSON)

// Click 'Try now' to see the response