First Leeward

Webhook event

Card Dispute Status Updated

POSTCARD_DISPUTE_STATUS_UPDATED

Fired when a card dispute status changes.

Body

application/json

idstringrequired

Unique event identifier for idempotency

typestringrequired

Webhook event type

Available options:CARD_DISPUTE_STATUS_UPDATED
dataobjectrequired
Show child attributes
idstring<uuid>required

Unique dispute identifier

transactionIdstring<uuid>required

The card transaction being disputed

cardIdstring<uuid>required

Card used for the disputed transaction

statusstringrequired

Current dispute status

Available options:RECEIVEDREVIEWINGSUBMITTEDWONLOSTREFUNDEDDECLINEDCANCELED
reasonstringrequired

Why the cardholder is disputing the transaction

Available options:FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEITFRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEITFRAUD_OTHER_CARD_PRESENTFRAUD_OTHER_CARD_ABSENTFRAUD_VISA_MONITORING_PROGRAMAUTHORIZATION_CARD_RECOVERY_BULLETINAUTHORIZATION_DECLINEDAUTHORIZATION_NO_AUTH_LATE_PRESENTMENTPROCESSING_ERROR_INCORRECT_TRANSACTION_CODEPROCESSING_ERROR_INCORRECT_CURRENCYPROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBERPROCESSING_ERROR_INCORRECT_AMOUNTPROCESSING_ERROR_DUPLICATE_PROCESSINGPROCESSING_ERROR_INVALID_DATACONSUMER_MERCHANDISE_NOT_RECEIVEDCONSUMER_CANCELLED_RECURRINGCONSUMER_NOT_AS_DESCRIBEDCONSUMER_COUNTERFEIT_MERCHANDISECONSUMER_MISREPRESENTATIONCONSUMER_CREDIT_NOT_PROCESSEDCONSUMER_CANCELLED_MERCHANDISECONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTEDCONSUMER_NON_RECEIPT_CASH_ATM
categorystringrequired

The grouping the reason belongs to

Available options:FRAUDAUTHORIZATIONPROCESSING_ERRORCONSUMER
amountobjectrequired

The cardholder amount under dispute, including FX and ATM fees. May be less than the transaction total.

Show child attributes
valuenumberrequired

Disputed amount

currencystringrequired

Currency of the disputed amount

refundedAmountobject | nullrequired

Amount credited to the cardholder when the dispute reaches REFUNDED. Includes the network refund plus a prorated FX markup and ATM variable fee. Does not include the per-withdrawal ATM fixed fee, which stays charged. Null until REFUNDED. May be less than the disputed amount. The same credit is recorded as a DISPUTE_REFUND event on the disputed card transaction and delivered in CARD_TRANSACTION_UPDATED; apply balance changes from that event, not from this field.

Show child attributes
valuenumberrequired

Amount credited to the cardholder

currencystringrequired

Currency of the refunded amount

cardholderobjectrequired

Cardholder identity on the case

Show child attributes
namestringrequired

Cardholder name on the case

emailstring<email>required

Cardholder email on the case

contactEmailstring<email>required

Address that receives the dispute outcome

resolvedAtstring<date-time> | nullrequired

When the dispute reached a final status, or null while open

createdAtstring<date-time>required

ISO 8601 timestamp of creation

updatedAtstring<date-time>required

ISO 8601 timestamp of last update

Response

200Webhook received successfully. Return any 2xx status to acknowledge.