On-Us

Update on-us dispute

Update on-us dispute. This endpoint updates a dispute for a non-branded authorization or transaction performed with a Pismo-issued card. Disputes are initially created with a PENDING status. Once ready, the issuer must call this endpoint with the OPEN event to submit the dispute and move the dispute status to OPENED.

For more information about on-us disputes and its state machine, refer to the On-us disputes guide.

This endpoint generates a Dispute status changed event.

Notes:

  • This endpoint takes an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.
  • The account ID, Org ID and cid (correlation identifier) are parsed from the account token.
post/v1/disputes-on-us/{disputeId}/event

Request

  • Base URL
    https://sandbox.pismolabs.io/disputes
  • URL
    https://sandbox.pismolabs.io/disputes/v1/disputes-on-us/{disputeId}/event
  • Auth
    HTTP bearer

Path parameters

disputeIdnumber required

Dispute ID

Request body

event'OPEN' | 'CANCEL' | 'EXPIRE' | 'REJECTS' | 'REOPEN' | 'PENDING_DOCUMENTATION' | 'RESEND' | 'ISSUER_LOSS' | 'STORE_OWNER_LOSS' | 'CARDHOLDER_LOSS' required

On-us dispute events

reasonstring

Reason for updating the on-us dispute

memostring

Additional notes about on-us dispute endpoint

Example request

{
  "event": "REOPEN",
  "reason": "Customer provided additional documentation"
}

Response

Dispute updated

dispute_idnumber required

Dispute ID

dispute_status'OPENED' | 'CANCELED' | 'REJECTED' | 'PENDING' | 'PENDING_DOCUMENTATION' | 'ISSUER_LOSS' | 'STORE_OWNER_LOSS' | 'CARDHOLDER_LOSS' | 'EXPIRED' required

On-us dispute statuses

Example response

{
  "dispute_id": 48670,
  "dispute_status": "OPENED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.