Monitor Card Payments (Acquiring)

  • 4 minute(s) read

Below is an example of a minimal request to monitor card payments in merchant acquiring scenario along with a mapping explaining the sample. In merchant acquiring the merchant is the account holder/customer, the card holder is the counterparty.

Info

Note: there is no need to transfer card data that is protected by PCI-DSS. BIN, last-4-digits and expiry date, ideally in combination with the holder name are unique enough for monitoring without giving expanding your PCI DSS scope

{
   "tenantTransactionId":"c45d18a6-2384-49aa-98ab-60134a50a5d7",
   "tenantProcessingTimestamp":"2020-06-05T16:20:01.618Z",
   "initiatingParty":"FUNDS_ORIGINATOR",
   "accountHoldingParty":"FUNDS_BENEFICIARY",
   "fundsOriginator":{
      "accountId":"8713672ec1687d0dbbe462e04125b513",
      "last4Digits":"2253",
      "bankIdentifier":"542810",
      "expiry":"202812",
      "scheme":"MASTER",
      "bankCountry":"BR"
   },
   "fundsBeneficiary":{
      "accountId":"421083",
      "holder":"Limo Rental",
      "bankCountry":"DE",
      "scheme":"CARD_MERCHANTACCOUNT"
   },
   "initiatedAmount":400.00,
   "initiatedCurrency":"USD",
   "settledAmount":328.13,
   "settledCurrency":"EUR",
   "usage":"Rental #2345763",
   "paymentType":"AUTHORIZATION_CAPTURE",
   "transactionResult":"ACCEPTED",
   "channel":"ECOMMERCE",
   "masterData":{
      "accountHoldingPartyData":{
         "riskLevel":"high",
         "companyDetails":{
            "businessPurposes":[
               "7512"
            ],
            "organizationType": "FOR_PROFIT",
            "inBusinessSince": "2019-06-05"
         },
         "contactDetails":{
            "country":"DE",
            "street":"Hannes Friedrichstr. 27",
            "town":"Munich",
            "zip":"82101"
         },
		 "characteristics": {
			"customerSince": "2020-01-15",
			"expectedTicketSizeAverage": 600,
			"expectedIncomeMonthly": 80000
		 }
      }
   }
}

Try it out here

Explanation

JSON Field description
{
      "tenantTransactionId":"c45d18a6-2384-49aa-98ab-60134a50a5d7", An ID that identifies the transaction uniquely in the client/tenant's system to link with cases
      "tenantProcessingTimestamp":"2020-06-05T16:20:01.618Z", Timestamp the transaction is processed at the tenant in UTC time
      "initiatingParty":"FUNDS_ORIGINATOR", Party that initiated the transaction
      "accountHoldingParty":"FUNDS_BENEFICIARY", Party holding the account - the bank/financial institutions customer
      "fundsOriginator":{ Account where funds originate - the payer in a payment (paymentType=PAYMENT)
            "accountId":"8713672ec1687d0dbbe462e04125b513", Some identifier for the card of the payer/counterparty e.g. a token, UUID or similar
            "last4Digits":"2253", Last four digits of the payer's card
            "bankIdentifier":"542810", Payer's Card BIN (first 6 digits of card number)
            "expiry":"202812", Payer's Card expiry. Format YYYYMM
            "scheme":"MASTER", Payer's Card scheme. Possible values: MASTER, VISA, AMEX, DISCOVER, MAESTRO, JCB, UNIONPAY
            "bankCountry":"BR" Payer's Card Issuing Country
      },
      "fundsBeneficiary":{ account that benefits from the funds transferred - the merchant account in a payment
            "accountId":"421083", Merchant ID
            "holder":"Limo  Rental", Merchant Name
            "bankCountry":"DE", Merchant Account country, matches processor/acquirer country issuing the merchant ID
            "scheme":"CARD_MERCHANTACCOUNT" Always CARD_MERCHANTACCOUNT for merchant
      },
      "initiatedAmount":400.00, Amount as it was initiated by the payer
      "initiatedCurrency":"USD", Initiated currency in ISO 4217 Alpha 3
      "settledAmount":328.13, Amount it will get settled on the account holder account, 0 e.g. for declines (NOTIFICATIONS) or AUTHORIZATIONS
      "settledCurrency":"EUR", Settlement currency in ISO 4217 Alpha 3
      "usage":"Rental  #2345763", Payment Descriptor
      "paymentType":"AUTHORIZATION_CAPTURE", Payment type, values: AUTHORIZATION_CAPTURE, AUTHORIZATION, CAPTURE, NOTIFICATION, REFUND, CHARGEBACK, REVERSAL, ACCOUNT_VERIFICATION and more
      "transactionResult":"ACCEPTED", ACCEPTED for succesful transaction for delines can be FRAUD_SUSPICION, CARD_STOLEN, CARD_LOST, INSUFFICIENT_FUNDS, SUSPICIOUS_MERCHANT_SETUP, INVALID_CVV and more
      "channel":"ECOMMERCE", Channel used. Values: ECOMMERCE, POS, MOTO, BACKOFFICE
      "masterData":{ Masterdata / Customer data
            "accountHoldingPartyData":{ Details about account holder = merchant
                  "riskLevel":"high", Merchant risk level as provided by Acquirer/Processor, values: low, medium, high
                  "companyDetails":{ Company details about the merchant
                        "businessPurposes":[
                              "7512" Merchant Category Code (MCC) or other business categorisation
                        ]
                  },
                  "contactDetails":{ Contact Details of merchant
                        "country":"DE", Merchant country
                        "street":"Hannes  Friedrichstr.  27", Merchant street
                        "town":"Munich", Merchant town
                        "zip":"82101" Merchant ZIP code
                  },
                  "characteristics":{ Special characteristics and capablities of merchant
                        "customerSince": "2020-01-15", Since when the merchant is a customer with the institution monitoring
                        "expectedTicketSizeAverage": 600, Predicted/Expected average ticket size of merchant during onboarding (in merchant base currency)
                        "expectedIncomeMonthly": 80000 Predicted/Expected monthly cumulative volume of merchant during onboarding (in merchant base currency)
                  }}}}