---
title: "Request Chargeback v2"
method: POST
path: "/pws/v2/pws_request_chargeback/"
tags: ["ChargeBack-V2"]
---

# Request Chargeback v2

`POST /pws/v2/pws_request_chargeback/`

## Request

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

This web service allows to perform chargeback request.</ul><p>Version 2 Request chargeback support idempotency.</p><ul>

## Request body

- RequestChargebackModel: This web service allows to perform chargeback request.
  - `api_call_unique_identifier` string, required: Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required: Unique identifier for the client which Paymentology will provide at outset
  - `fn_code` string, 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_code` string, 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&mdash;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: &bull; AP region and MEA region &bull;Europe region and participating countries in MEA region1 &bull;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&ndash;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_set` integer, required: RID Settlement (unique Id for settlement)
  - `user_id` string: User Id of the Customer who triggered the API request.
  - `remarks` string: Remarks for API request
  - `reason_txt` string: Reason Text
  - `doc_ind_id` integer: 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_id` integer: 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_amt` number: Partial Amount if chargeback is Partial
  - `is_reverse` boolean: Is chargeback Reversal

## Response `200`

Successful Response

- RequestChargebackResponseModel
  - `header` ResponseHeader
    - `error_id` integer: Error Id
    - `error_desc` string: Error Message
  - `body` RequestChargebackResponseModelBody
    - `token` integer: Public Token
    - `rid_set` integer: RID Settlement
    - `de4` string: transaction Amount
    - `de6` string: Billing Amount
    - `de31` string: Acquirer Reference Data
    - `de43` string: card Acceptor Name/Location
    - `irn_de95` string: card Issuer Reference Data (Issuer's Reference Number)

## Other responses

- `404`: Webservices does not exist
- `500`: Internal Server error

## Changes

- **2026-11-03** `73c2771493b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymentology/apis/payapi-docs/changes/pws/v2/pws_request_chargeback/post.md)

---

[API](https://skmtc.dev/paymentology/apis/payapi-docs.md) - [All operations](https://skmtc.dev/paymentology/apis/payapi-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/payapi-docs/revisions/73c2771493b1?raw)