PApaymentology
Transaction

Request chargeback

Changed on

This web service allows to perform chargeback request.

post/pws/pws_request_chargeback/

Request

  • Base URL
    https://api.uat.paymentology.com/ppws/api
  • URL
    https://api.uat.paymentology.com/ppws/api/pws/pws_request_chargeback/
  • Auth
    none declared

Request body

api_call_unique_identifierstring required

Unique number that must be passed at each API request. Identifier to make each API request unique

client_idinteger required

Unique identifier for the client which Paymentology will provide at outset

fn_codestring required

Function Code/ chargeback type. <ul><li class="docBullet">450 : First chargeback (Full)</li><li class="docBullet">453 : First chargeback (Partial)</li><li class="docBullet">451 : Arbitration chargeback (Full)</li><li class="docBullet">454 : Arbitration chargeback (Partial)</li></ul>

reason_codestring required

Reason Code. <ul><li class="docBullet">4515 : Cardholder Denies transaction Finalized</li><li class="docBullet">4801 : Requested transaction data was not received within maximum time frame. Not permitted for the PVL brand</li><li class="docBullet">4802 : Requested information illegible or missing within maximum time frame</li><li class="docBullet">4804 : Multiple Processing, Duplicate (used only by the MasterCard Network for European- acquired transactions)</li><li class="docBullet">4807 : Warning bulletin</li><li class="docBullet">4808 : Requested/required authorization not obtained</li><li class="docBullet">4809 : transaction Not Reconciled (Used only by the MasterCard Network for European- acquired transactions)</li><li class="docBullet">4811 : Stale transaction (Used by the MasterCard Network only for European- acquired transactions)</li><li class="docBullet">4812 : account number was not on file.</li><li class="docBullet">4831 : transaction amount differs.</li><li class="docBullet">4834 : Duplicate processing</li><li class="docBullet">4837 : Fraudulent transaction; no cardholder authorization</li><li class="docBullet">4840 : Fraudulent processing of transaction</li><li class="docBullet">4841 : Canceled recurring transaction</li><li class="docBullet">4842 : Late presentment</li><li class="docBullet">4846 : Correct transaction currency code was not provided.</li><li class="docBullet">4849 : Questionable card acceptor activity</li><li class="docBullet">4849 : Questionable card acceptor activity</li><li class="docBullet">4850 : Installment transaction Dispute18</li><li class="docBullet">4853 : Cardholder Dispute Defective/Not as Described</li><li class="docBullet">4854 : Cardholder dispute not elsewhere classified (U.S. only)</li><li class="docBullet">4855 : Non-receipt of merchandise</li><li class="docBullet">4859 : services not rendered</li><li class="docBullet">4860 : Credit not processed</li><li class="docBullet">4863 : Cardholder does not recognize—Potential fraud</li><li class="docBullet">4870 : Chip Liability Shift Valid for all intraregional transactions except those involving U.S. region and all interregional transactions between the following: • AP region and MEA region •Europe region and participating countries in MEA region1 •Europe region and participating countries in AP region2</li><li class="docBullet">4871 : Chip/PIN Liability Shift* ** Reserved for intra-Europe and intra-Canada</li><li class="docBullet">4880 : Maestro Late Presentment *Applies only to non-intra- European and non-inter- European Maestro chip-read and PIN-based POS transactions **Applies only to Maestro transactions</li><li class="docBullet">4890 : Identifies a syntax error return</li><li class="docBullet">4898 : Reserved for Future Use</li><li class="docBullet">4900 : General; invalid Second Presentment/1240; Second Presentment/1240 did not remedy First chargeback/ 1442; this message reason code cannot be submitted in IPM format.</li><li class="docBullet">4901 : Required documentation not received to support prior Second Presentment/1240.</li><li class="docBullet">4902 : Documentation received was illegible.</li><li class="docBullet">4903 : Scanning error–unrelated documents or partial scan</li><li class="docBullet">4905 : Invalid Acquirer Reference Data in Second Presentment/ 1240; no documentation required or provided</li><li class="docBullet">4908 : Invalid Acquirer Reference Data in Second Presentment/ 1240; documentation was received.</li><li class="docBullet">4999 : Domestic chargeback Dispute Reserved for intra-European and inter-European use</li></ul>

rid_setinteger required

RID Settlement (unique Id for settlement)

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

reason_txtstring

Reason Text

doc_ind_idinteger

Document Index Id. <ul><li class="docBullet">0 : Supporting documentation is not required</li><li class="docBullet">1 : Supporting documentation will follow</li></ul>

post_cb_idinteger

Post Chargeabck action Id. <ul><li class="docBullet">1 : Apply Credited amount to Customer account</li><li class="docBullet">2 : Apply Credited amount to chargeback Credits account</li></ul>

partial_amtnumber

Partial Amount if chargeback is Partial

is_reverseboolean

Is chargeback Reversal

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "client_id": 760131,
  "fn_code": "450",
  "reason_code": "4808",
  "rid_set": 11221000003,
  "doc_ind_id": 1,
  "post_cb_id": 1
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": {
    "token": 336869349,
    "rid_set": 11964567849,
    "de4": "000000006000",
    "de6": "000000006000",
    "de31": "02720290239082700000030",
    "de43": "FIRST THIRD BANK \\1234 Main Street\\LONDON \\1111111111 GBR\n",
    "irn_de95": "0000034045"
  }
}

Changes