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 Acquirers

  • Banco Safra
  • Bank Sinarmas (Omise Ltd.)
  • BC Card Co., Ltd.
  • Citibank Malaysia
  • CTBC Bank Ltd.
  • Sumitomo Mitsui Card Co.
  • Vietnam Technological and Commercial Joint-Stock Bank

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
Forced Captures

Simple Order Example: Forced Captures

Request
<requestMessage
    xmlns="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>
</requestMessage>
Response to a Successful Request
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="Timestamp-576203304">
                <wsu:Created>2023-08-08T16:45:33.955Z</wsu:Created>
            </wsu:Timestamp>
        </wsse:Security>
    </soap:Header>
    <soap:Body>
        <c: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:pos>
                <c:terminalID>111111</c:terminalID>
            </c:pos>
        </c:replyMessage>
    </soap:Body>
</soap:Envelope>
Forced Captures