Fraud Push Notifications
Process for Creating Subscription for the Customers
Step 1 - Provide the customer system details as per the following template for pushing the fraud transactions.
| API Name | Data Type / Example | Description |
| CustomerAuthType | String Oauth/ BasicAuth/ CID, CS |
Authentication type of customer end point subscribed to Push functionality, currently we are supporting OAuth (client_credentials)type and BasicAuth |
| CustomerOauthToken GrantType |
String "client_credentials" |
GrandType of OAuth authentication which customer system supports. |
| CustomerOauthToken ApiEndPoint |
String https://login.microsoftonline.com/********/oauth2/token |
Token endpoint detail of customer system. |
| CustomerApiEndPoint AuthHeaderName |
String "X-Apigee-Authorization/Authorization" |
Header name of customer system which will accept the OAuth token |
| CustomerApiEndPoint | String https://example.com/api/HttpTrigger |
API endpoint of customer system where will accept the push transaction from shell |
| CustomerApiEndPoint ClientID |
String "***********" |
Clinet_id to generate OAuth Token |
| CustomerApiEndPoint ClientSecretName |
String "client_secret" |
client_secret to generate OAuth Token |
| PayerNumber | String "GB000000123" |
Payer Number of the selected payer. Example, GB000000123 |
| AccountNumber | String "GB000000123" |
Account Number (example, GB000000123) of the selected account. When Account number are not present on request, the response will have all accounts under the selected payer. |
Step 2 - Send customer details through email to :
- GXDSITRetailSFSBISupport@shell.com
Step 3 - Upon receiving subscription template, Shell will enable the subscription for customers.
Step 4 - Customers will start receiving the fraud messages in the designated place (endpoint URL of a customer) specified in the template.
Payload Template
{
"TransactionHeader": {
"TransactionItemId": "TransactionId",
"MessageSendDt": {},
"TransactionTypeNm": "B2BFUELCARD",
"transaction_item_id": "transactionId",
"MessageVersionNbr": "v1.0"
},
"RiskCategoryTxt": "Location Mismatch",
"DeviceDetailsNm": "Robrecht Busselen",
"CardPanMaskedTxt": "70****************502",
"DeviceDetailsLicensePlateNo": "PJ14DTN",
"CardVRNNo": "MV65YLH",
"DeviceDetailsId": "b1",
"TransactionTimeMismatchInd": "Y",
"TransactionTimeMismatchVal": {},
"TelematicsTransactionDtm": {},
"LocationMismatchInd": "Y",
"DistanceVal": "104.9853752",
"DeviceLocationDesc": "XYZ SHELL EXPRESS",
"TransactionSiteLocationDesc": "NINOVE SHELL EXPRESS, NINOVE, 9400",
"VolumeMismatchInd": "Y",
"VolumeMismatchAmt": -12.22,
"TransactionQty": "43.72",
"DeviceFuelUpEventDetailsDerivedVol": "31.5",
"TransactionOverCapacityInd": "N",
"TransactionOverCapacityAmt": "string",
"TankCapacityVol": "40",
"OdometerReadingMismatchInd": "N",
"TransactionOdometerReadingMismatchVal": "1200",
"DeviceFuelUpEventDetailsOdometerVal": "62924818.3211186",
"OdometerReadingVal": "12345",
"CustomerInvoiceTotalNetAmt": "1234.456",
"CustomerCurrencyISOCd": "GBP",
"NoTransactionInd": "N",
"SourceCardId": "H3051367722",
"ColcoCd": "13",
"LegalEntityCustomerNo": "GB000000123",
"AccountCustomerNo": "GB000000321",
"NoFuelCardTransactionInd": "N",
"FuelUpEventVol": "203.23"
}