PApaymentology
Card

ACS Authentication FSS

Changed on

This API is used for Transaction Authentication from ACS to MB Server

post/pws/pws_acs_authentication/

Request

  • Base URL
    https://api.uat.paymentology.com/ppws/api
  • URL
    https://api.uat.paymentology.com/ppws/api/pws/pws_acs_authentication/
  • Auth
    none declared

Request body

amountstring required

Transaction amount in minor units of the ongoing transaction.

authTypestring required

Authentication type 0 - No Client Authentication – (Only OTP Delivery) 1- Client authentication (OOB)

currencyCodestring required

Currency in which amount is expressed.

exponentstring required

Minor units of Currency Code.

merchantNamestring required

Name of Merchant where transaction was initiated.

messageCategorystring required

Txn payment type 01- Payment 02- Non Payment.

proxyCardstring required

This represents the Token Number / Alias Number which will be used in place of Card Number (this would be shared with ACS during Registration).

tranIDstring required

Unique txn ID generated by ACS for every transaction.

otpstring

OTP [If Encrypted OTP is sent in this field]. MB Server has to send the same to Card Holder.

encvaluestring

Encrypted dynamic DEK using KEK

dstranIDstring

Unique reference ID received from Mastercard DS in every Authentication Request message (AREQ)

merchantURLstring

Merchant App URL that Authentication App can call the Merchant app after OOB authentication has occurred.

Example request

{
  "amount": "100028",
  "authType": "1",
  "currencyCode": "191",
  "exponent": "2",
  "merchantName": "amazon",
  "messageCategory": "01",
  "proxyCard": "121345566",
  "tranID": "0fdf0f56-053b-457f-bae1-e77e966f66ca",
  "otp": "7878675645342312345678909865432",
  "encvalue": "b6fd1fcc8f0129693664fe101a637d99",
  "dstranID": "64fe101a637d99b6fd1fcc8f01296936",
  "merchantURL": "merchantScheme://appName?transID=b2385523-a66c-4907-ac3c-91848e8c0067"
}

Response

Successful Response

descriptionstring required

Result description

oobTypestring required

Performed authentication method If Zero, values would be [OTP Sent] If Single, values would be [biometric (or) pattern] If Dual, values will be comma separated biometric, pattern

proxyCardstring required

card proxy number received in request.

resultCodestring required

Result code to indicate whether transaction was success or failed • 00-Success • 01-Declined

tranIdstring required

Unique txn ID generated by ACS for every transaction.

tranIDstring

Example response

{
  "oobType": "biometric",
  "proxyCard": "121345566",
  "resultCode": "00",
  "tranId": "0fdf0f56-053b-457f-bae1-e77e966f66ca",
  "status": {
    "code": "00"
  }
}

Changes