Skip to main content

Debit and Prepaid Partial Authorizations

Partial authorizations and balance responses are special features that are available for debit cards and prepaid cards. This section shows you how to enable partial authorizations for a specific transaction.

Supported Processors

  • AIBMS
  • American Express Direct
  • Banque de France et Trésor Public
  • Barclays
  • BNP Paribas France
  • Chase Paymentech Solutions
  • Cielo
  • Comercio Latino
  • Credit Mutuel-CIC
  • Elavon Americas
  • FDC Compass
  • FDC Nashville Global
  • FDI Australia
  • FDMS Nashville
  • Getnet
  • GPN
  • HBOS
  • HSBC
  • JCN Gateway
  • Lloyds-OmniPay
  • LloydsTSB Cardnet
  • Moneris
  • OmniPay Direct
  • Prosa
  • Rede
  • RuPay HDFC
  • SIX
  • Streamline
  • TSYS Acquiring Solutions
  • UATP
  • Vero
  • Worldpay VAP
  • Barclays
  • TSYS Acquiring Solutions
  • Chase Paymentech Solutions
  • Elavon Americas
  • FDC Nashville Global
  • Streamline
  • Worldpay VAP

Processor-Specific Information

: to globally process domestic debit transactions with Mastercard in Canada, you must contact customer support to have your account configured for this feature.

Field Specific to this Use Case

Include this field in addition to the fields required for a standard authorization request:

  • Indicate that this request is a partial authorization. Set the processingInformation.authorizationOptions.partialAuthIndicator to true.

Endpoints

POST /pts/v2/payments

POST /pts/v2/payments

POST /pts/v2/payments

Example

{  "clientReferenceInformation" : {    "code" : "TC50171_3"  },  "orderInformation" : {    "billTo" : {      "country" : "US",      "lastName" : "Deo",      "address2" : "Address 2",      "address1" : "201 S. Division St.",      "postalCode" : "48104-2201",      "locality" : "Ann Arbor",      "administrativeArea" : "MI",      "firstName" : "John",      "phoneNumber" : "999999999",      "district" : "MI",      "buildingNumber" : "123",      "company" : "Visa",      "email" : ""    },    "amountDetails" : {      "totalAmount" : "1000.00",      "currency" : "USD"    }  },  "paymentInformation" : {    "card" : {      "expirationYear" : "2031",      "number" : "5555555555xxxxxx",      "securityCode" : "123",      "expirationMonth" : "12",      "type" : "002"    }  },  "processingInformation" : {    "authorizationOptions" : {      "partialAuthIndicator" : "true"    }  }}
{  "_links" : {    "self" : {      "method" : "GET",      "href" : "/pts/v2/payments/6595549144566655003494"    }  },  "clientReferenceInformation" : {    "code" : "TC50171_3"  },  "id" : "6595549144566655003494",  "orderInformation" : {    "amountDetails" : {      "totalAmount" : "1000.00",      "authorizedAmount" : "499.01",      "currency" : "USD"    }  },  "paymentInformation" : {    "accountFeatures" : {      "currency" : "usd",      "balanceAmount" : "0.00"    }  },  "pointOfSaleInformation" : {    "terminalId" : "261996"  },  "processorInformation" : {    "merchantNumber" : "000000092345678",    "approvalCode" : "888888",    "cardVerification" : {      "resultCode" : ""    },    "networkTransactionId" : "123456789619999",    "transactionId" : "123456789619999",    "responseCode" : "100",    "avs" : {      "code" : "X",      "codeRaw" : "I1"    }  },  "reconciliationId" : "56059417N6C86KTJ",  "status" : "PARTIAL_AUTHORIZED",  "submitTimeUtc" : "2022-08-03T19:28:34Z"}

Required Fields

Use these required fields for enabling debit and prepaid partial authorizations.

FieldDescription
clientReferenceInformation.codeOrder reference or tracking number. Provide a unique value for each transaction so that you can perform meaningful searches for the transaction.
orderInformation.amountDetails.currency
For RuPay HDFC: Set the value to INR. For Vero: Vero supports Brazilian real (BRL) currency only.
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.card.type—
paymentInformation.card.expirationMonth—
paymentInformation.card.expirationYear—
paymentInformation.card.number—
processingInformation.authorizationOptions.partialAuthIndicatorSet the value to true.

Optional Field

You can use this optional field to include additional information when enabling debit and prepaid partial authorizations.

Optional Field
FieldDescription
processingInformation.linkIdset this field to the request ID that was returned in the response message from the original authorization request.

Last published: September 29, 2026