Create on-us dispute

Create an on-us dispute. This allows issuers to create 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 Update on-us dispute with the OPEN event to submit the dispute and move the dispute's 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 On-us dispute created 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 401 Unauthorized message.
  • The account ID, Org ID, and CID (correlation identifer) are parsed from the account token.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Create On-Us dispute request body

source_identifier
object
required
integer
enum
required

On-us issuer reason code:

  • 1 - Services not provided or product not received
  • 2 - Defective product or not as described
  • 3 - Nonexistent card number / Closed or nonexistent account
  • 4 - Authorization denied / No authorization
  • 5 - Fraud - Card present
  • 6 - Fraud - Card not present
  • 7 - Duplicate processing
  • 8 - Processing error
boolean
required
Defaults to false

Is partial amount chargeback? Default is false.

number
required

Disputed amount.

string | null

Client custom dispute comment.

string
length ≤ 500

Client custom protocol ID. This is primarily for you to internally identify a request. If not provided, Pismo creates a CID (correlation ID) field for this purpose.

metadata
object

Can be used for caller's dispute information and process. Objects and name-value pairs.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json