Refunds

Request refund approval

POST/api/v1/pawapay/refunds/request-approval

Same OTP-gated pattern as payouts, for refunding a deposit — request a code first.

Requires Authorization

ADMIN only

Payout OTP

Body parameters

`depositId`stringrequired	The deposit being refunded.
`amount`number	Omit to refund the full amount.
`currency`string
`country`string
`provider`string

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/pawapay/refunds/request-approval \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "depositId": "<depositId>",
  "amount": "<amount>",
  "currency": "<currency>",
  "country": "<country>",
  "provider": "<provider>"
}'

200Example response

{
  "success": true,
  "data": {
    "pendingId": "1a2b3c4d-5e6f-7890-1a2b-3c4d5e6f7890",
    "message": "Un code de vérification a été envoyé à admin@swiftgoma.com.",
    "expiresInMinutes": 5
  }
}