Get data of pre-arbitration

Get data of pre-arbitration
Pre-arbitration information request description and example
  • Method: POST , URL /pre_arbitration
  • Fields for signature calculation: <X-Nonce><ShopPassword>
Field Usage Description
file_date_from optional Starting date for files to return in response in “YYYY-MM-DD” format
file_date_to optional End date for files to return in response in “YYYY-MM-DD” format
shop_codes optional Array list of shop codes
merchant_id optional Merchant identification number(MID)
acq_ref_nrs optional Transaction “Acquirer reference number”
payment_ids optional Array list of unique transaction' s payment ID(s) in the processing system
payment_order_nrs optional Array list of unique order ID/bill number in the merchant system
page optional Page number of results, starting with 0. Default value is 0.
per_page optional Number of chargebacks per page, as value between 10 and 1000. Default value is 10.
sortKey optional Parameter to sort by, possible values:
ID
SHOP_CODE
MERCHANT_ID
ACQ_REF_NR
PAYMENT_ORDER_NR
sortOrder optional Sorting order for sortKey argument, possible values "asc" or "desc", default is "asc"(ascending).
Request example
{
  "shop_codes": null,
  "merchant_id": "3401602",
  "acq_ref_nrs": [ "MWMy5zITi3hHheCnG3GPJ8i" ],
  "payment_ids": null,
  "payment_order_nrs": null,
  "file_date_from": "2017-11-10",
  "file_date_to": "2017-11-10",
  "page": 0,
  "per_page": 10,
  "sortKey": null,
  "sortOrder": null
}
          
Pre-arbitration information response description and example
Field Description
List of content as array
content.bank_id Bank Id from FD pre-arbitration file name
content.file_date Date from FD pre-arbitration file name (YYYY-MM-DD)
content.card Masked PAN (mask template 123456%1234)
content.acq_ref_nr Transaction “Acquirer reference number”
content.merchant_id Merchant identification number
content.merchant_name Merchant description (ISO8583 field 43)
content.tr_date_time Transaction date YYYY-MM-DD HH24:MM:SS
content.amount Original Transaction amount (as originally processed by merchant), format- point as decimal sign and 2 decimals. Left padded with spaces.
content.ccy Transaction amount currency code
content.xid Transaction Identifier
content.transaction_id A unique number given by the Network to identify a Cardmember Transaction throughout its life cycle
content.card_acceptor_id The Service Establishment (S/E) number assigned by AmericanExpress
content.case_date Pre-arbitration case date, format ‘YYYY-MM-DD’
content.case_stage Case description
content.fdl_comments Additional merchant comments in support of decision.
content.merchant_decision Used by merchant to communicate the decision to FD with regards to prearb acceptance. “accept” or "rebuttal"
content.payment_id Payment identification code – unique identified used to identify payments in PGW interface.
content.payment_order_nr Related invoice order_id
Pagination information
totalPages Total number of pages for selection done with current "page" and "per_page" in request
totalElements Total number of pre-arbitrations matching the request parameters.
Example response
{
  "content": [
    {
      "bank_id": "29",
      "file_date": "2017-10-27",
      "card": "431422%0056",
      "acq_ref_nr": "75400786062012917262158",
      "merchant_id": "3401602",
      "merchant_name": "TEST.COM",
      "tr_date_time": "2017-08-23 19:06:05",
      "amount": 123.11,
      "ccy": "EUR",
      "xid": null,
      "transaction_id": null,
      "card_acceptor_id": null,
      "case_date": "2017-08-23",
      "case_stage": "Pre-Arbitration",
      "fdl_comments": null,
      "merchant_decision": null,
      "payment_id": "20926343",
      "payment_order_nr": "order-462123"
    },
    {
      "bank_id": "29",
      "file_date": "2017-10-27",
      "card": "431422%0056",
      "acq_ref_nr": "75400786024012733916598",
      "merchant_id": "3401602",
      "merchant_name": "TEST.COM",
      "tr_date_time": "2017-08-27 19:06:05",
      "amount": 10.11,
      "ccy": "EUR",
      "xid": null,
      "transaction_id": null,
      "card_acceptor_id": null,
      "case_date": "2017-08-27",
      "case_stage": "Pre-Arbitration",
      "fdl_comments": null,
      "merchant_decision": null,
      "payment_id": "20942704",
      "payment_order_nr": "order-434i-12041"
    },
    {
      "bank_id": "29",
      "file_date": "2017-10-29",
      "card": "431422%0056",
      "acq_ref_nr": "75400786062012917262158",
      "merchant_id": "3401602",
      "merchant_name": "TEST.COM",
      "tr_date_time": "2017-08-23 19:06:05",
      "amount": 111.11,
      "ccy": "EUR",
      "xid": null,
      "transaction_id": null,
      "card_acceptor_id": null,
      "case_date": "2017-08-23",
      "case_stage": "Pre-Arbitration",
      "fdl_comments": null,
      "merchant_decision": null,
      "payment_id": "20926343",
      "payment_order_nr": "order-462123"
    },
    {
      "bank_id": "29",
      "file_date": "2017-11-03",
      "card": "431422%0049",
      "acq_ref_nr": "75400786062012917262158",
      "merchant_id": "3401602",
      "merchant_name": "TEST.COM",
      "tr_date_time": "2017-08-30 19:06:05",
      "amount": 33.44,
      "ccy": "EUR",
      "xid": null,
      "transaction_id": null,
      "card_acceptor_id": null,
      "case_date": "2017-11-03",
      "case_stage": "Pre-Arbitration",
      "fdl_comments": null,
      "merchant_decision": null,
      "payment_id": "20926343",
      "payment_order_nr": "order-462123"
    },
    {
      "bank_id": "29",
      "file_date": "2017-11-03",
      "card": "431422%0049",
      "acq_ref_nr": "75400786062012917262777",
      "merchant_id": "3401603",
      "merchant_name": "TEST.COM",
      "tr_date_time": "2017-10-24 19:06:05",
      "amount": 10.00,
      "ccy": "EUR",
      "xid": null,
      "transaction_id": null,
      "card_acceptor_id": null,
      "case_date": "2017-11-03",
      "case_stage": "Pre-Arbitration",
      "fdl_comments": null,
      "merchant_decision": null,
      "payment_id": "21131114",
      "payment_order_nr": "cdAYVXMxW8TAHPCgvtvJ"
    }
  ],
  "totalPages": 1,
  "totalElements": 5
}