On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-debit-prepaid-process-intro/payments-debit-prepaid-part-auth-intro.md)  
Filter  
FILTER BY TAG

Enabling Debit and Prepaid Partial Authorizations {#payments-debit-prepaid-part-auth-intro}
===========================================================================================

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.  
To globally process domestic debit transactions on `Visa Platform Connect` with Mastercard in Canada, you must contact customer support to have your account configured for this feature.  
You must use version 1.52 or later of the XML schema to implement partial authorizations or balance responses.

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 `ccAuthService_partialAuthIndicator` to `true`.

Endpoint {#payments-debit-prepaid-part-auth-intro_d7e16}
--------------------------------------------------------

Set the ccAuthService_run field to `true`.  
Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`.

Required Fields for Enabling Debit and Prepaid Partial Authorizations {#payments-debit-prepaid-part-auth-required}
==================================================================================================================

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

> When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/payments/developer/ctv/so/payments/payments-relax-reqs.md "").

billTo_city
:

billTo_country
:

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_postalCode
:

billTo_state
:

billTo_street1
:

card_accountNumber
:

card_expirationMonth
:

card_expirationYear
:

ccAuthService_partialAuthIndicator
:
Set the value to `true`.

ccAuthService_run
:
Set the value to `true`.

merchantID
:

merchantReferenceCode
:

purchaseTotals_currency

purchaseTotals_grandTotalAmount
:

Related Information {#payments-debit-prepaid-part-auth-required_section_lwm_yxz_sxb}
------------------------------------------------------------------------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")
  {#payments-debit-prepaid-part-auth-required_ul_mwm_yxz_sxb}

Optional Field for Enabling Debit and Prepaid Partial Authorizations {#payments-debit-prepaid-part-auth-optional}
=================================================================================================================

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

linkToRequest
:
Set this field to the request ID that was returned in the response message from the original authorization request.

Related Information {#payments-debit-prepaid-part-auth-optional_section_w5w_zxz_sxb}
------------------------------------------------------------------------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")
  {#payments-debit-prepaid-part-auth-optional_ul_x5w_zxz_sxb}

Simple Order Example: Enabling Debit and Prepaid Partial Authorizations {#payments-debit-prepaid-part-auth-ex-so}
=================================================================================================================

Request

```keyword
billTo_street1=201 S. Division St
billTo_city=Ann Arbor
billTo_country=US
billTo_state=MI
billTo_postalCode=48104-2201
billTo_email=test@cybs.com
billTo_firstname=John
billTo_lastname=Deo
card_expirationMonth=12
card_expirationYear=2031
card_accountNumber=5555555555554444
ccAuthService_partialAuthIndicator=true
merchant_id=pa_ctv_sg101
merchantReferenceCode=TC50171_3
purchaseTotals_currency=usd
purchaseTotals_grandTotalAmount=1000.00
```

Response to a Successful Request

```
apCaptureService_authRequestID=6618807769750178232890
apAuthReply_reconciliationID=6618807769750178232890
card_cardType=002
ccAuthReply_amount=1000.00
ccAuthReply_avsCode=Y
ccAuthReply_authorizationCode=831000
ccAuthReply_authorizedDateTime=2022-08-30T173257Z
ccAuthReply_avsCodeRaw=Y
ccAuthReply_cavvResponseCode=2
ccAuthReply_cavvResponseCodeRaw=2
ccAuthReply_merchantAdviceCode=01
ccAuthReply_merchantAdviceCodeRaw=M001
ccAuthReply_processorResponse=00
ccAuthReply_reconciliationReferenceNumber=224217876503
ccCreditReply_paymentNetworkTransactionID=MCC9689130830
merchantReferenceCode=TC50171_3
payerAuthEnrollReply_cardTypeName=MASTERCARD
purchaseTotals_currency=usd
receiptNumber=876503
requestID=6618807769750178232890
```

RELATED TO THIS PAGE