An OCT deposits funds into a recipient’s account.

Required Fields for Performing an OCT

These fields are required in a request for an OCT:
card_accountNumber
Not required when you are using a customer token.
card_expirationMonth
Not required when you are using a customer token.
card_expirationYear
Not required when you are using a customer token.
invoiceHeader_businessApplicationID
Not required when your account includes this value.
merchantID
merchantReferenceCode
octService_run
Set this field to
true
.
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Cannot exceed 50,000 USD.

Performing an OCT

Do not include any other services in the request.
Follow these steps to perform an OCT:
  1. Request the service. Set the
    octService_run
    field to
    true
    , and send the request to one of these endpoints:
    • https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • https://ics2wsa.ic3.com/commerce/1.x/transactionProcessor
  2. Include the required fields in the request.
  3. Include optional fields in the request as needed.
  4. Check the response message to make sure that the request was successful. A value of
    ACCEPT
    for the
    decision
    field indicates success.
    For information about error codes, see Cybersource Payouts Error Codes.
    For information about reason codes, see Reason Codes for the Simple Order API.

Cybersource
Payouts Error Codes

These error codes pertain to Payouts OCTs processed by
Barclays
.
ESYSTEM with reason code 154
Error message detail:
Bad MAC code error response
Error description: A MAC address mismatch exists between
Barclays
and
Cybersource
. The Payouts service sends the
Cybersource
operations team an alert requesting a MAC code reset by
Barclays
.
Error remediation: After the
Barclays
reset operation completes, retry the payment.
If this error occurs multiple times in quick succession, an underlying error condition is indicated. Contact customer support.
ETIMEOUT with response code 268
Error message detail:
Transaction Error: unable to confirm, please contact Barclaycard help desk.
Error description: Both an initial retry request and an automated retry request fail to process, and
Cybersource
does not know if the payout was successful or rejected.
Error remediation: Do not retry the payment.

NVP Example: OCT Request Using the Simple Order API

Request: OCT Service
merchantID=FlowerShop merchantReferenceCode=123456789 purchaseTotals_currency=USD purchaseTotals_grandTotalAmount=100.00 card_accountNumber=4111111111111111 card_expirationMonth=12 card_expirationYear=2022 invoiceHeader_businessApplicationID=FD octService_run=true
Response: OCT Service
merchantReferenceCode=123456789 decision=ACCEPT reasonCode=100 purchaseTotals_currency=USD octReply_reasonCode=100 octReply_reconciliationID=94820975023471 octReply_processorResponse=00 octReply_approvalCode=831000 octReply_amount=2500.00 octReply_paymentNetworkTransactionID=012345678912345

XML Example: OCT Request Using the Simple Order API

Request: OCT Service
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.179"> <?xml version="1.0" encoding="utf-8"?> <merchantReferenceCode>123456789</merchantReferenceCode> <merchantID>FlowerShip</merchantID> <purchaseTotals> <currency>USD</currency> <grandTotalAmount>100.00</grandTotalAmount> </purchaseTotals> <card> <accountNumber>4111111111111111</accountNumber> <expirationMonth>12</expirationMonth> <expirationYear>2022</expirationYear> </card> <invoiceHeader> <businessApplicationID>FD</businessApplicationID> </invoiceHeader> <octService run="true"> </octService> </requestMessage>
Response: OCT Service
<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.179"> <merchantReferenceCode>123456789</merchantReferenceCode> <requestID>6213511233610181632928</requestID> <decision>ACCEPT</decision> <reasonCode>100</reasonCode> <purchaseTotals_currency>USD</purchaseTotals_currency> <octReply> <reasonCode>100</reasonCode> <requestDateTime>2020-10-23T23:24:32Z</requestDateTime> <processorResponse>00</processorResponse> <approvalCode>100</approvalCode> <amount>100.00</amount> </octReply> </replyMessage>

Testing the OCT Service

  1. Use Visa payment card numbers to test the OCT service. Do not use real payment card numbers. Remove spaces when sending card numbers to
    Cybersource
    .

Visa Test Payment Card Numbers

Use these payment card numbers to test the OCT service:
Visa Payment Card Numbers for Testing the OCT Service
Card Type
Card Number
CVV
Expiration Date
Credit card
4111 1111 1111 1110
Credit card
4487 9720 0000 0010
Credit card
4957 0304 2021 0490
Debit card
4622 9410 0000 0000
973
12/2022
Debit card
4622 9411 0000 0000
166
12/2022
Debit card
4622 9411 0000 0010
916
12/2022
Debit card
4622 9411 0000 0020
142
12/2022
Debit card
4622 9411 0000 0030
109
12/2022
Debit card
4622 9411 0000 0040
932
12/2022
Debit card
4622 9411 0000 0050
177
12/2022
Debit card
4622 9411 0000 0060
286
12/2022
Debit card
4622 9411 0000 0070
860
12/2022
Debit card
4622 9411 0000 0080
948
12/2022
Debit card
4622 9411 0000 0090
567
12/2022
Debit card
4895 2500 0000 0000
482
12/2022
Debit card
4895 3700 3000 0010
199
12/2022
Prepaid card
4895 2800 0000 0000
153
12/2022
Prepaid card
4895 2811 0000 0000
108
12/2022
Prepaid card
4895 2811 0000 0010
516
12/2022
Prepaid card
4895 2811 0000 0020
414
12/2022
Prepaid card
4895 2811 0000 0030
425
12/2022
Prepaid card
4895 2811 0000 0040
383
12/2022
Prepaid card
4895 2811 0000 0050
520
12/2022
Prepaid card
4895 2811 0000 0060
164
12/2022
Prepaid card
4895 2811 0000 0070
741
12/2022
Prepaid card
4895 2811 0000 0080
350
12/2022
Prepaid card
4895 2811 0000 0090
656
12/2022
Prepaid card
4895 3100 0000 0000
865
12/2022
Prepaid card
4895 3200 0000 0000
950
12/2022