Disputes And Refunds API

Refunds, reversals, and disputes are controlled financial actions. They are never implemented as direct balance edits.

Current Surface

  • Card disputes are exposed through the managed-card dispute flow.
  • Giftcard and transaction reversals are tracked through financial operations and review queues.
  • Merchant webhook and transaction verification flows should be used before requesting manual intervention.

Endpoints

Endpoint Method Auth Headers Notes
Create card dispute
/cards/api/v1/disputes/
Open a card dispute case linked to an authorization event.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits