On This Page

Authorize a Mastercard Payment on Paze with Merchant Decryption

The topics in this section show you how to authorize a Mastercard payment on Paze using the merchant decryption method.

Basic Steps: Authorizing a Mastercard Payment on Paze with Merchant Decryption

Follow these steps to request a Paze payment authorization with merchant decryption for Mastercard:

Create the request message with the required REST API fields.

ADDITIONAL INFORMATION

Use the API fields listed in Required Fields for Authorizing a Mastercard Payment on Paze with Merchant Decryption.

Refer to the example in REST Example: Authorize a Mastercard Payment on Paze with Merchant Decryption.

Send the message to one of these endpoints:

ADDITIONAL INFORMATION

Production:

POST https://api.visaacceptance.com/pts/v2/payments

Test:

POST https://apitest.visaacceptance.com/pts/v2/payments

Verify the response messages to make sure that the request was successful.

ADDITIONAL INFORMATION

A 200-level HTTP response code indicates success. See the

Transaction Response Codes

Required Fields for Authorizing a Mastercard Payment on Paze with Merchant Decryption

As a best practice, include these REST API fields in your request for an authorization with the merchant decryption implementation of Paze for Mastercard.

IMPORTANT

Depending on your processor, your geographic location, and whether the relaxed address verification system (RAVS) is enabled for your account, some of these fields might not be required. It is your responsibility to determine whether an API field can be omitted from the transaction you are requesting.

For information about the relaxed requirements for address data and expiration dates in payment transactions, see the

Payments Developer Guide

clientReferenceInformation.code
consumerAuthenticationInformation.ucafAuthenticationData: Set this field to the Token Secure cryptogram.
consumerAuthenticationInformation.ucafCollectionIndicator: Set this field to
2
for a Mastercard payment on Paze using merchant decryption.
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
orderInformation.billTo.address1
orderInformation.billTo.administrativeArea
orderInformation.billTo.country
orderInformation.billTo.email
orderInformation.billTo.firstName
orderInformation.billTo.lastName
orderInformation.billTo.locality
orderInformation.billTo.postalCode
paymentInformation.tokenizedCard.cryptogram: Set this field to the network token cryptogram.
paymentInformation.tokenizedCard.expirationMonth: Set this field to the value from the payment network token expiration month.
paymentInformation.tokenizedCard.expirationYear: Set this field to the value from the payment network token expiration year.
paymentInformation.tokenizedCard.number: Set this field to the payment network token value.
paymentInformation.tokenizedCard.transactionType: Set this field to
1
.
paymentInformation.tokenizedCard.type: Set this field to
002
for Mastercard.
processingInformation.commerceIndicator: Set this field to
spa
.
processingInformation.paymentSolution: Set this field to
029
to specify the Paze payment solution.

REST Example: Authorize a Mastercard Payment on Paze with Merchant Decryption

Request

{
  "clientReferenceInformation": {
    "code": "1234567890"
  },
  "processingInformation": {
    "paymentSolution": "029",
    "commerceIndicator": "spa"
  },
  "paymentInformation": {
    "tokenizedCard": {
      "number": "5432543254325432",
      "expirationMonth": "12",
      "expirationYear": "2031",
      "cryptogram": "ABCDEFabcdefABCDEFabcdef0987654321234567",
      "transactionType": "1",
      "type": "002"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "100.00",
      "currency": "USD"
    },
    "billTo": {
      "firstName": "Maya",
      "lastName": "Lee",
      "address1": "123MainSt",
      "locality": "SomeCity",
      "administrativeArea": "CA",
      "postalCode": "94404",
      "country": "US",
      "email": "[email protected]"
    }
  },
  "consumerAuthenticationInformation": {
    "ucafAuthenticationData": "ABCDEFabcdefABCDEFabcdef0987654321234567",
    "ucafCollectionIndicator": "2"
  }
}

Response to a Successful Request

{
  "_links": {
    "authReversal": {
      "method": "POST",
      "href": "/pts/v2/payments/6234236182176225003004/reversals"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/6234236182176225003004"
    },
    "capture": {
      "method": "POST",
      "href": "/pts/v2/payments/6234236182176225003004/captures"
    }
  },
  "clientReferenceInformation": {
    "code": "1234567890"
  },
  "id": "6234236182176225003004",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "100.00",
      "currency": "USD"
    }
  },
  "paymentInformation": {
    "tokenizedCard": {
      "expirationYear": "2031",
      "prefix": "543254",
      "expirationMonth": "12",
      "suffix": "5432",
      "type": "002"
    },
    "card": {
      "type": "002"
    }
  },
  "pointOfSaleInformation": {
    "terminalId": "111111"
  },
  "processingInformation": {
    "paymentSolution": "029"
  },
  "processorInformation": {
    "approvalCode": "888888",
    "networkTransactionId": "123456789619999",
    "transactionId": "123456789619999",
    "responseCode": "100",
    "avs": {
      "code": "X",
      "codeRaw": "I1"
    }
  },
  "reconciliationId": "75729760OPN67ZFV",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2021-06-11T15:00:18Z"
}