Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Fees

Create dispute fee

A dispute fee, or fee collection in network terminology, is a way for an acquirer and issuer to exchange money outside the normal chargeback process. Typically, this means reversing a settled chargeback, but not always,

You can use this endpoint to create a dispute fee with or without a chargeback claim ID. You can create a dispute fee for a claim that already exists or, if it doesn't, you can pass the necessary authorization information to create it.

For more information, refer to Dispute fees in the Disputes overview guide. This feature is only available for Mastercard and Elo.

This endpoint generates a Dispute fee status created event.

Note: 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.

post/v1/fee

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

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.

Request body

amountnumber double required

Fee amount.

card_idinteger required

Enrolled card ID

credit_senderboolean required

Credit the sender? Default is false.

credit_receiverboolean required

Credit the receiver? Default is false.

currencystring required

ISO 4217 fee currency code.

destination_memberstring required

Destination member for the fee collection. These values are known to the network and identify either the issuer or acquirer.

fee_datestring date required

Date the fee was attached to the claim, format = yyyy-mm-dd.

network_brand_type'Visa' | 'Mastercard' | 'Elo' required

Network brand

reason_codestring required

Collection reason code. These codes can be found in Mastercard's Global Clearing Management System Reference Manual starting on page 408.

authorization_idnumber

Authorization ID. REQUIRED if claim_id and arn is not passed.

arnstring

Acquirer reference number. REQUIRED if claim_id is not passed.

transaction_amountnumber double

Transaction amount. REQUIRED if claim_id is not passed.

transaction_datestring date-time

Transaction date, format = yyyy-mm-dd hh:mm:ss. REQUIRED if claim_id is not passed.

claim_idstring

Fee item claim ID

card_acceptor_codestring

Merchant ID associated with this fee collection, if any.

country_codestring

ISO 3166 3-letter country code.

messagestring

Message regarding fee - 100 chars maximum.

settlement_datestring date

Settlement date, format = yyyy-mm-dd.

reply_fee_idstring

Fee ID to be sent in reply to created Fee.

control_numberstring

Control number. Used in routing chargeback and retrieval documentation - either a MasterCom endpoint suffix, in case of 2 characters, or a full MasterCom endpoint in case of 7 characters. When MasterCom control number is present, it cannot be all spaces or all zeros.

Example request

{
  "amount": 100,
  "card_id": 6743052,
  "currency": "USD",
  "destination_member": "002083",
  "fee_date": "2021-02-15",
  "network_brand_type": "Visa",
  "reason_code": "7604",
  "arn": "1564984",
  "transaction_amount": 100,
  "transaction_date": "2022-06-01 10:25:36",
  "claim_id": "121698491",
  "card_acceptor_code": "Test1234",
  "country_code": "USA",
  "message": "Cardholder recognized the transaction",
  "settlement_date": "2021-09-22",
  "reply_fee_id": "300009520876",
  "control_number": "1589457"
}

Response

OK

idnumber

Dispute fee ID

arnstring

Acquirer reference number. REQUIRED if claim_id is not passed.

transaction_amountnumber double

Transaction amount. REQUIRED if claim_id is not passed.

transaction_datestring date-time

Transaction date, format = yyyy-mm-dd hh:mm:ss. REQUIRED if claim_id is not passed.

card_idinteger

Enrolled card ID

card_acceptor_codestring

Merchant ID associated with this fee collection..if any.

country_codestring

ISO country code.

destination_memberstring

Destination member for the fee collection. These values are known to the network and identify either the acquirer or issuer.

fee_datestring date

Date the fee was attached to the claim, format = yyyy-mm-dd

currencystring

ISO 4217 currency code.

amountnumber double

Fee amount.

messagestring

Message regarding fee - 100 chars maximum.

reason_codestring

Collection reason code. These codes can be found in Mastercard's Global Clearing Management System Reference Manual starting on page 408.

settlement_datestring date

Settlement date, format = yyyy-mm-dd.

control_numberstring

Control number

credit_senderboolean

Credit the sender? Default is false.

credit_receiverboolean

Should receiver be credited?

network_brand_type'Visa' | 'Mastercard' | 'Elo'

Network brand

status'PENDING' | 'PROCESSED' | 'FAILED'

Dispute fee status - PENDING, PROCESSED, or FAILED.

chargeback_ref_numstring

Chargeback reference number

reconciliation_amountnumber double

Reconciliation amount

reconciliation_currencystring

Reconciliation currency

japan_common_merchant_codestring

Japanese common merchant codes

installment_datastring

Installment data

reply_fee_idstring

Fee ID to send to reply to created fee.

reject_reasonstring

Reject reason

created_atstring

When dispute created, format = yyyy-mm-ddThh:mm:ss"

updated_atstring date-time

Datetime program calendar strategy was updated. Format = YYYY-MM-DDTHH:MM:SS:MM

created_at_utcstring date-time

Dispute created in UTC date/time.

updated_at_utcstring

When dispute updated in UTC date/time.

Example response

{
  "id": 152,
  "arn": "1564984",
  "transaction_date": "2022-06-01 10:25:36",
  "card_id": 6743052,
  "card_acceptor_code": "Test1234",
  "country_code": "USA",
  "destination_member": "002083",
  "fee_date": "2021-02-15",
  "currency": "USD",
  "amount": 100,
  "message": "Cardholder recognized transaction",
  "reason_code": "7604",
  "settlement_date": "2021-09-22",
  "control_number": "1589457",
  "network_brand_type": "Visa",
  "status": "PENDING",
  "chargeback_ref_num": "9000000006",
  "reconciliation_amount": 123.22,
  "reconciliation_currency": "EUR",
  "japan_common_merchant_code": "0410",
  "installment_data": "1234567890",
  "reply_fee_id": "300009520876",
  "reject_reason": "Code1=0142(00):D0063/002;DE072=D0063\\\\\\\\\\\\\\\\8000000808\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ ",
  "created_at": "2222-10-07T11:21:45",
  "updated_at": "2024-09-12T16:46:16.43663522",
  "created_at_utc": "2021-02-21T22:51:43.000000000Z",
  "updated_at_utc": "2022-10-13T19:56:010000000Z"
}