Authentication

The API uses basic authentication by adding the username and password in the auth header as Base64 encoded string appended to the text "Basic". The Chargeback system requires merchant specific API credentials be created separately from your normal ConnexPay CRM user.

API Reference

Parameter

Description

ID

ConnexPay specific ID

UUID

Processor specific Identifier

FileID

ConnexPay specific ID that identifies which file this chargeback came in on

MerchantID

The ID of the Merchant

Arn

The ARN (Acquirer Reference Number) of the chargeback. If there are multiple chargebacks or chargeback events associated with the same transaction/chargeback, they will all have the same Arn (but different Case Numbers).

CaseNumber

The Case Number of the chargeback

Amount

Amount of the chargeback

RecordType

Possible values are Blank or R

CaseType

Record descriptor for the case. See Ref CaseTypes for a list of available types and descriptions.

ReasonCode

Reason Code and Reason Description go hand in hand. See Ref ReasonCodes for a list of available types and descriptions.

ReasonDescription

See Reason Code section above

CardBrand

1 - Visa
2 - MasterCard
3 - Discover
4 - American Express
5 - PayPal

TransactionCode

05 - Credit
06 - Debit

ResolutionTo

Resolution To indicates the party responsible for responding to a specific case. As a chargeback transitions through its various states, new cases (related by FamilyId) are created with specific Resolution To values indicating the party responsible for acting.

M - means the merchant is responsible for responding to the current case

B - means the bank is responsible for responding to the current case

S - means the chargeback has been resolved to split, meaning a partial credit has been issued

G - means the case has been moved to the general ledger and is likely being offset by another duplicate or related chargeback

TransactionDate

Date of the original transaction (not the date of the chargeback)

LoadDate

The date the chargeback was loaded in to the system

PostDate

The date the chargeback was posted in to the system

ResolvedDate

The date the chargeback was resolved

FamilyId

Aka, Chargeback Id, this Id groups chargeback data together into a “family” of related cases for a given chargeback.

HasImage

Indicates if there is supporting documentation for the particular chargeback

HasResponse

Indicates if the chargeback has been responded to

ImageFileUrl

The URL of the image file containing the supporting documentation of the chargeback

Created

Date and time record was created in database

OrderNumber

Order number submitted with the original transaction. This is what most clients will want to use to tie the chargeback in their system

DueDate

This is when the chargeback needs to be responded to based on the chargeback rules about time to respond

IsSurrendered

IdSale

IncomingTransactionCode

SaleGuid

SaleFirstFour

SaleLastFour

AuthCode

NetPosition

The total of debits and credits for a particular Chargeback.

WinLoss

The Win / Loss is defined by how your bank account is impacted by referring mainly to the Net Position.

Reference

Case Types

Case Types identify the various phases of a chargeback dispute. Each phase is represented by a new case that relates back to a given chargeback.

Code

Description

Abbreviation

0

Retrieval

R

1

First Chargeback

FC

2

Second Chargeback

SC

3

First Reversal

FR

4

Second Reversal

SR

9

Visa Pre Arb

VPA

17

Amex Retrieval

AR

18

Amex Chargeback

AC

19

Amex Reversal

ARV

20

Allocation

ALC

21

Collaboration

CL

22

Allocation Reversal

ALRV

23

Collaboration Reversal

CLRV

24

Collaboration Pre Arb

CPA

11

Disc Retrieval

DR

12

Disc Chargeback

DSC

13

Disc Reversal

DSR

14

Disc PreArb

DSPA

15

Disc Incoming Dispute Arb

DSID

16

Disc PreArb/Arb Debit

DSPD

Reason Codes

Reason codes identify the reason for the dispute. Each of the major card brands, including Visa, Mastercard, and others, have their own system of reason codes.

CodeDescriptionCardType
10.1EMV Liability Shift Non-Counterfeit FraudVisa
10.2EMV Liability Shift Counterfeit FraudVisa
10.3Other Fraud - Card-Present EnvVisa
10.4Other Fraud - Card-Absent EnvVisa
10.5Visa Fraud Monitoring ProgramVisa
11.1Card Recovery BulletinVisa
11.2Declined AuthVisa
11.3No AuthVisa
12.1Late PresentmentVisa
12.2Incorrect Transaction CodeVisa
12.3Incorrect CurrencyVisa
12.4Incorrect Account NumberVisa
12.5Incorrect AmountVisa
12.7Invalid DataVisa
12.6Dup Process/Paid by Other MeansVisa
13.1Merch/Svc Not RecdVisa
13.2Cancelled Recurring TransactionVisa
13.3Not as Described or Defective MerchVisa
13.4Counterfeit MerchVisa
13.5MisrepresentationVisa
13.6Credit Not ProcessedVisa
13.7Cancelled Merch/SvcVisa
13.8Orig Credit Transaction Not AcceptedVisa
13.9Non-Receipt of Cash or LoadVisa
4808Auth related chargebackMastercard
4812Account Number Not on fileMastercard
4841Cancelled Recurring or Dig GoodsMastercard
4853Cardholder DisputesMastercard
4854Cardholder Disputes-Not elsewhere classifiedMastercard
4855Goods or Services Not ProvidedMastercard
4837No Cardholder AuthMastercard
4840Fraudulent Processing of TransactionMastercard
4849Questionable Merchant ActivityMastercard
4863Cardholder Does Not Recognize/Potential FruadMastercard
4870Chip Liability ShiftMastercard
4871Chip/PIN Liability Shift-Lost/Stolen/Never Recd Issue FraudMastercard
4831incorrect Trans AmountMastercard
4834Point of Interaction - POIMastercard
4842Late PresentmentMastercard
4846Incorrect Currency CodeMastercard
Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!