Forced Captures

This feature allows merchants to process authorizations obtained through an organization other than
Cybersource
. For example, a merchant might call their processor to request a manual authorization, at which point they can request a forced capture of the authorization.
A manual authorization cannot be captured for more than the original authorization amount, and the authorization expires after seven days.

Supported Services

  • Authorization

Required Fields for Forced Captures

Use these required fields for processing forced captures.
authIndicator
Set the value to
0
 for preauthorizations, or to
1
 for final authorizations..
billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set the value to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount

Simple Order Example: Forced Captures

Light Dark
Request
123456789101112131415161718192021222324252627
<="urn:schemas-cybersource-com:transaction-data-1.{{WSDLVersion}}">
    <merchantID>testrest</merchantID>
    <billTo>
        <firstName>John</firstName>
        <lastName>Doe</lastName>
        <street1>1295 Charleston Road</street1>
        <city>Mountain View</city>
        <state>CA</state>
        <postalCode>94043</postalCode>
        <country>US</country>
        <email>test@cybs.com</email>
    </billTo>
    <purchaseTotals>
        <currency>USD</currency>
        <grandTotalAmount>1.02</grandTotalAmount>
    </purchaseTotals>
    <card>
        <accountNumber>4111111111111111</accountNumber>
        <expirationMonth>12</expirationMonth>
        <expirationYear>2023</expirationYear>
        <cardType>001</cardType>
    </card>
    <ccAuthService run="true">
        <authType>verbal</authType>
        <verbalAuthCode>ABC123</verbalAuthCode>
    </ccAuthService>
</>
Response to a Successful Request
123456789101112131415161718
<:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.142">
    <c:merchantReferenceCode>Postman-1691513134</c:merchantReferenceCode>
    <c:requestID>6915131335966844703009</c:requestID>
    <c:decision>ACCEPT</c:decision>
    <c:reasonCode>100</c:reasonCode>
    <c:purchaseTotals>
        <c:currency>USD</c:currency>
    </c:purchaseTotals>
    <c:ccAuthReply>
        <c:reasonCode>100</c:reasonCode>
        <c:amount>1.02</c:amount>
        <c:authorizationCode>ABC123</c:authorizationCode>
        <c:authorizedDateTime>2023-08-08T16:45:33Z</c:authorizedDateTime>
    </c:ccAuthReply>
    <c:card>
         <c:cardType>001</c:cardType>
    </c:card>
</c:replyMessage>