Simulate a returned payout

POST/api/partner/sandbox/payouts/{id}/return

Key scope: partner key · Staging only

Staging only. The payee's bank refuses a sandbox payout before it is paid: state returned, event payout.returned.

All codes: Errors.

Request

curl -X POST "https://wallet.simpleeasytransactions.com/api/partner/sandbox/payouts/<id>/return" \
  -H "Authorization: Bearer $SET_PARTNER_KEY"

Response 200

{ "object": "payout", "id": "sim_drain_…", "state": "returned", "paid": false, "sandbox": true, "message": "Sandbox: …" }