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 totrue.
- 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:
- Request the service. Set theoctService_runfield totrue, 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
- Include the required fields in the request.
- Include optional fields in the request as needed.
- Check the response message to make sure that the request was successful. A value ofACCEPTfor thedecisionfield 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
Cybersource
Payouts Error CodesThese 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 betweenBarclaysandCybersource. The Payouts service sends theCybersourceoperations team an alert requesting a MAC code reset byBarclays.
- Error remediation: After theBarclaysreset 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, andCybersourcedoes 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
- Use Visa payment card numbers to test the OCT service. Do not use real payment card numbers. Remove spaces when sending card numbers toCybersource.
Visa Test Payment Card Numbers
Use these payment card numbers to test 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 |