Payment Attributes

The GetPayment call may return one or more Attributes. These are name-value pairs that can give additional information regarding the payment.

The following attributes are supported:

  • FinanceInvoiceID – the ID of the invoice this payment was invoiced on
  • FinanceEstateID – the ID of the Statement this payment was included on
  • AuthorisationCode – for Payvision Creditcard transactions only: An XML structure with the codes returned by Payvision indicating the transactions was accepted or not, see below for an example
  • RedshieldResponse – only for Creditcard transactions where Fraud Check is enabled: a JSON structure with information from ACI Redshield regarding the transaction, including BIN and Expiry Date, see below for an example.

Payvision Authorisation Code

See example below:

<?xml version="1.0"?>
<TransactionResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ExtensionData />
 <Cdc>
    <CdcEntry>
      <ExtensionData />
      <Items>
        <CdcEntryItem>
          <ExtensionData />
          <Key>BankCode</Key>
          <Value>00</Value>
        </CdcEntryItem>
        <CdcEntryItem>
          <ExtensionData />
          <Key>BankMessage</Key>
          <Value>Approved</Value>
        </CdcEntryItem>
        <CdcEntryItem>
          <ExtensionData />
          <Key>BankApprovalCode</Key>
          <Value>909893</Value>
        </CdcEntryItem>
        <CdcEntryItem>
          <ExtensionData />
          <Key>CVVResult</Key>
          <Value>U</Value>
        </CdcEntryItem>
        <CdcEntryItem>
          <ExtensionData />
          <Key>Warning</Key>
          <Value>avsAddress and/or avsZip empty</Value>
        </CdcEntryItem>
      </Items>
      <Name>BankInformation</Name>
    </CdcEntry>
    <CdcEntry>
      <ExtensionData />
      <Items>
        <CdcEntryItem>
          <ExtensionData />
          <Key>CardId</Key>
          <Value>42136161</Value>
        </CdcEntryItem>
        <CdcEntryItem>
          <ExtensionData />
          <Key>CardGuid</Key>
          <Value>9f95e4cb-9486-44e6-8a43-de3bbe67da92</Value>
        </CdcEntryItem>
      </Items>
      <Name>CardInformation</Name>
    </CdcEntry>
  </Cdc>
  <Message>The operation was successfully processed.</Message>
  <Result>0</Result>
  <TrackingMemberCode>10660388</TrackingMemberCode>
  <TransactionDateTime>2018-02-06T09:16:05.6377689Z</TransactionDateTime>
  <TransactionGuid>7cc10a6e-e4fe-4050-98fc-d6d81e429cc9</TransactionGuid>
  <TransactionId>88825445</TransactionId>
</TransactionResult>

Redshield Response

{
                "id": "8a8294496155b05b01616566b2035109",
                "paymentBrand": null,
                "amount": "100.00",
                "currency": "EUR",
                "merchantTransactionId": "10660376",
                "result": {
                               "code": "000.000.000",
                               "description": "Transaction succeeded",
                               "parameterErrors": null
                },
                "resultDetails": {
                               "RiskStatusCode": "PENDING",
                               "ResponseCode": null,
                               "RequestId": "350536634049",
                               "RiskResponseCode": "0100",
                               "RiskFraudStatusCode": "ACCEPT",
                               "OrderId": "494167077538"
                },
                "card": {
                               "bin": "554698",
                               "last4Digits": "0033",
                               "holder": "test test",
                               "expiryMonth": "01",
                               "expiryYear": "2020"
                },
                "customParameters": {
                               "RED_ACCT_NUM": "554698**********",
                               "RED_CARD_EXP_DT": "0120"
                },
                "buildNumber": "dd4e18a001842f4407085ea93a4397b7d6f4dc3d@2018-02-01 15:21:15 +0000",
                "timestamp": "2018-02-05 09:58:05+0000",
                "ndc": "8a8294185a184b44015a237960ae1840_f777b99a167a411d80ddb2a728539a0d"

The following is a list of possible fraud statuses:

STAT_CD

FRAUD_STAT_CD

FRAUD_RSP_CD

Description

Full Description

ACCEPT/DECLINE

NOSCORE

0000

No decision provided

Transaction not screened.  No fraud screening decision is given.

ACCEPT/DECLINE

ACCEPT

0100

Transaction accepted

Accept

ACCEPT/DECLINE

ACCEPT

0150

Always accept rule

An attribute associated with an Order matched a pre-configured "Always Accept" rule.

SUSPEND

DENY

0200

Transaction took place on a lost or stolen card

The card number appeared in a bank or card association negative file database.

SUSPEND

DENY

0250

Always deny rule

An attribute associated with an Order matched a pre-configured "Always Deny" rule.

SUSPEND

CHALLENGE

0300

Transaction challenged due to custom rules

A combination of customised rules and neural-based fraud assessments has determined the card usage is suspicious and possibly fraudulent.

SUSPEND

CHALLENGE

0330

Transaction hit a velocity or rule threshold

A customised rule in the ACI ReD Shield Velocity Rules Engine returned a CHALLENGE response.

SUSPEND

DENY

0400

Denied transaction due to a hit on a suspicious database and a high neural score

A combination of customised rules and neural-based fraud assessments has determined the card usage is suspicious and possibly fraudulent and the card number appeared in a ACI Retail Decisions card database.

SUSPEND

CHALLENGE

0500

Challenged transaction due to high neural score

A combination of customised rules and neural-based fraud assessments has determined the card usage is questionable and possibly fraudulent. The overall ACI ReD Shield assessment has fallen into a "grey area", as defined by ACI and the Client.

SUSPEND

DENY

0600

Card number found in a database of suspicious cards

The card number associated with the Order was found in a ACI Retail Decisions card database.

SUSPEND

DENY

0700

Transaction hit a velocity or rule threshold

Velocity or Rules Threshold Violation – An attribute associated with an Order has exceeded a preconfigured rules threshold.

SUSPEND

DENY

0800

Card generation pattern detected

Tumbling and/or Swapping Pattern Detected – The ACI ReD Shield Tumbling and Swapping engine detected an unusual usage pattern in the card number, expiration date, or customer email address associated with a transaction.

ACCEPT/DECLINE

ACCEPT

1000

Transaction accepted due to always accept in ReD SDS service

An attribute associated with an Order matched a pre-configured “Always Accept” screening entry in the ACI ReD Shield proprietary screening database service.

SUSPEND

CHALLENGE

1300

Transaction challenged due to a hit on a suspicious database.

The transaction has been flagged in a screening database.

SUSPEND

DENY

2000

Fraudulent transactions have already been seen with details in your request

An attribute associated with an Order matched a negative entry in the ACI ReD Shield proprietary screening database service.

SUSPEND

ERROR

901

System Error or missing fields

An internal ACI ReD Shield error has occurred or the EBT_Name and EBT_Service parameters are not being sent.

SUSPEND

ERROR

902

Information missing/bad data

The format of a particular field is invalid or a required input field is missing.  Please check your transaction string

SUSPEND

ERROR

903

Request exceeds limit

The request message into ReD Shield has exceeded the byte limit.