On This Page
Payouts Developer Guide
Payouts
Developer GuideThis section describes how to use this guide and where to find further information.
Audience and Purpose
This document is written for developers who want to use the
Cybersource
APIs to integrate Cybersource
Payouts
services into their transaction management system. Conventions
This statement is used in this document:
IMPORTANT
An
Important
statement contains information essential to
successfully completing a task or learning a concept.Related Documentation
Visit the
Cybersource
documentation hub on the Cybersource Developer Center for
links to further documentation resources. Customer Support
For support information about any service, visit the Support Center:
Recent Revisions to This Document
26.06.01
This revision contains only editorial changes and no technical
updates.
25.08.01
This revision contains only
editorial changes and no technical updates.
25.05.01
This revision contains only editorial changes and no technical updates.
24.11.01
Made updates throughout guide.
24.09.01
Updated terminology from
client token
to customer token
.24.06.01
Reorganized the document.
Introduction to Payouts
Payouts
The
Payouts
service transfers funds from one account to
another account using this two-step transaction process:- Anaccount funding transaction(AFT) withdraws funds from a sender’s account using standard credit card processing.
- Anoriginal credit transaction(OCT) deposits the funds into a recipient’s account.
An AFT and OCT are independent transactions, however, an AFT often precedes a
corresponding OCT.
During standard payment transactions, you initiate debits and credits to receive payments
from cardholders for your goods and services. With
Payouts
,
you provide a money transfer service by initiating AFT and OCT transactions that move
funds between accounts. These are the money transfer types:- Anaccount-to-accountpayment transfers funds between accounts owned by the same person.
- Abusiness-to-personpayment transfers funds between a merchant and a cardholder.
- Aperson-to-personpayment transfers funds between two cardholders.
For a person-to-person funds transfer, Pull and Push services are executed. When an AFT
is authorized for a person-to-person transaction, the funds are available and can be
withdrawn from the sender's account. This service is known as a
Pull
service. A
subsequent OCT is authorized, and the funds are deposited into the recipient's account.
This service is known as a Push
service. The
Payouts
system ensures that both Pull and Push services
are executed efficiently, providing a seamless experience for users. By leveraging
Payouts
, businesses and individuals can streamline their
financial operations, making transactions more efficient and reliable.No merchant goods are involved in
Payouts
transactions.IMPORTANT
You must receive approval from
your processor
before using the AFT
service. Contact your processor
to register for the AFT
program.Relaxed Requirements for Address Data and Expiration Date for AFTs
You can have your
Cybersource
account configured to enable relaxed
requirements for address data and expiration date in your AFT request.- Relaxed Requirements for Address Data
- Address Verification Service (AVS) compares portions of the billing address from the request message with address data on file at the issuing bank. Results are returned for the street address and for the postal code. Relaxed requirements for address data allow you to make address fields that are normally required, such as billing address, optional in your transaction request.
- Relaxed Requirements for Expiration Date
- The card expiration month and year from the request message are compared with the card expiration date on file at the issuing bank. Relaxed requirements for expiration date allow you to make expiration date fields optional in your transaction request.
To enable relaxed requirements for address data and expiration date, contact customer
support to configure your account for this feature.
Supported Recipient Card Types, Currencies, and
Transactions
Supported Recipient Card Types, Currencies, and
Transactions
The recipient card type for OCT is Visa.
Recipient card type for
AFTs:
- Mastercard
- Visa
Payment Network
Payment Network
Barclays
, Chase Paymentech Solutions
, FDC Compass
, and Visa Platform Connect
- Visa Direct
- The Visa Direct payment network provides these functions forPayouts:
- Enhanced message types for OCTs.
- Account funding transactions (AFTs), which provide funds for OCTs.
- Processes, policies, and underlying operating regulations and mandates for issuers and acquirers.
- Mastercard Send
- The Mastercard Send payment network transfers funds to Mastercard products. Mastercard Send enables customers to move funds quickly and safely and receive disbursements from businesses and governments.
Overview
The
Payouts
service transfers funds from one account to
another using a two-step transaction process:- An account funding transaction (AFT) withdraws funds from a sender’s account using standard credit card processing.
- An original credit transaction (OCT) deposits funds into a recipient’s account.
An AFT and OCT are independent transactions, though an AFT often precedes a
corresponding OCT.
In typical payment transactions, you initiate debits and credits to receive payments
from cardholders for your goods and services. With
Payouts
, you provide a money transfer service by initiating AFT and OCT transactions that
move funds between accounts. These are the money transfer types:- An account-to-account payment moves funds between accounts owned by the same person.
- A business-to-person payment moves funds between a merchant and a cardholder.
- A person-to-person payment moves funds between two cardholders.
For a person-to-person funds transfer, Pull and Push services are executed. When an
AFT is authorized for a person-to-person transaction, the funds are available and
can be withdrawn from the sender's account. This service is referred to as a Pull
service. A subsequent OCT is authorized, and the funds can deposited into the
recipient's account. This service is referred to a Push service.
The
Payouts
system ensures that both Pull and Push
services are executed efficiently, providing a seamless experience for users. By
leveraging Payouts
, businesses and individuals can
streamline their financial operations, making transactions more efficient and
reliable.No merchant goods are involved in
Payouts
transactions.IMPORTANT
You must receive approval from
your processor
before using the AFT
service. Contact your processor
to register in the
AFT program.AFT Types
The Account Funding Transaction (AFT) is a specific type of transaction that moves funds
from a Visa account to another Visa or non-Visa account. It is primarily used for
loading or topping up prepaid card accounts, transferring funds into another financial
account (like a savings account), acting as a funding source for person-to-person (P2P)
money transfers, or loading third-party digital wallets. AFTs cannot be used for
purchasing goods or services or transferring funds to a merchant account.
AFTs are the required transactions to load or top-up prepaid cards in all regions. An AFT
is the required pull transaction to be used for disbursing payroll funds, P2P or
me-to-me transactions, and pre-funding a customer's digital wallet in a card-not-present
environment. When used independently to fund another Visa or non-Visa account, AFTs must
be used only to fund an account belonging to the same individual or entity holding the
Visa account.
Reversal and Adjustment Transactions
You can reverse an AFT within the first 24 hours of the original transaction before
the transaction settles.
You can refund an AFT back to the sender's card within 30 days of the original AFT
back to the sender's card. You cannot originate a refund if the original transaction
is over 30 days old. The system accepts a refund after the original AFT settles.
IMPORTANT
Issuers can manage AFT refunds as credit adjustments instead of
posting the transaction directly into the cardholder's account. Therefore, the timeframe
for when the cardholder should expect the refund will vary by issuer.
Relaxed Requirements for Address Data and Expiration Date for AFTs
You can have your
Cybersource
account configured to enable
relaxed requirements for address data and expiration date in your AFT request.- Relaxed Requirements for Address Data
- Address Verification Service (AVS) compares portions of the billing address from the request message with address data on file at the issuing bank. Results are returned for the street address and for the postal code. Relaxed requirements for address data allow you to make address fields that are normally required, such as billing address, optional in your transaction request.
- Relaxed Requirements for Expiration Date
- The card expiration month and year from the request message are compared with the card expiration date on file at the issuing bank. Relaxed requirements for expiration date allow you to make expiration date fields optional in your transaction request.
To enable relaxed requirements for address data and expiration date,
contact customer support to configure your account for this feature.
Supported Recipient Card Types, Currencies, and
Transactions
Supported Recipient Card Types, Currencies, and
Transactions
The recipient card type for OCT is Visa.
Recipient card type for AFTs:
- Mastercard
- Visa
These currencies are supported:
GBP and
USDAccount Funding
Transactions
The Account Funding Transaction (AFT) enables the transfer of funds between a payment
card and another account, including other payment cards. When used independently, an AFT
can only transfer funds between accounts owned by the same person or business entity. An
AFT is not intended to pay for goods and services, fund a merchant account, or repay
debts.
IMPORTANT
You must receive approval from before using the AFT services. Contact to register in the AFT program.
AFT Transaction Types
The Account Funding Transaction (AFT) is a specific type of transaction that moves
funds from a Visa account to another Visa or non-Visa account. It is primarily used
for:
- Loading or topping up prepaid card accounts.
- Transferring funds into another financial account, such as a savings account.
- Acting as a funding source for person-to-person (P2P) money transfers.
- Loading third-party digital wallets.
You cannot use an AFT for purchasing goods or services or transferring funds to a
merchant account.
AFTs are the required transactions to load or top-up prepaid cards in all regions. An
AFT is the required pull transaction to be used for disbursing payroll funds, P2P or
me-to-me transactions, and pre-funding a customer's digital wallet in a
card-not-present environment. When used independently to fund another Visa or
non-Visa account, AFTs must be used only to fund an account belonging to the same
individual or entity holding the Visa account.
Reverse or Adjust AFT Transactions
You can reverse an AFT within the first 24 hours of the original transaction before
the transaction settles.
You can refund an AFT back to the sender's card within 30 days of the original AFT.
You cannot originate a refund if the original transaction is over 30 days old. The
system accepts a refund after the original AFT settles.
IMPORTANT
Issuers can manage AFT refunds as credit adjustments instead of posting the
transaction directly into the cardholder's account. Therefore, the time-frame
for when the cardholder should expect the refund will vary by issuer.
Process an AFT with a Visa Card
Payouts
uses the authorization service to support AFTs. An
AFT withdraws funds from a sender’s account.IMPORTANT
You must receive prior approval from before using the AFT
services. Contact to register with the AFT program.
Barclays
Barclays
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/paymentsTest:
POST
https://apitest.cybersource.com
/pts/v2/paymentsRequired Fields for Performing an AFT with Visa
These fields are required in a request for an authorization for an AFT:
- Required except when your account is configured for relaxed requirements for address data and expiration date.
- Set totrue.
- These are the values when using a Visa card type:
- AA: Account-to-account, sender and recipient are the same person
- FT: Funds transfer where OCT not available
- TU: Top up - prepaid load
- WT: When AFT is used to fund a staged digital wallet
- processingInformation.purposeOfPayment
- Required for all cross-border transactions into and out of Canada. Also required for cross-border AFTs into Australia, New Zealand, and the South Pacific.
- Required for all cross-border money and non-money transfer transactions into and out of Canada.
- For the US and Canada, must be a valid two character state code.
- Required for all cross-border money and non-money transfer transactions into and out of Canada.
- Required for all cross-border money and non-money transfer transactions into and out of Canada.
- Required with Visa when transactions are in the US or Canada. Field is optional for countries outside of the US and Canada.
- Required for all cross-border money transfer AFTs.
Optional Fields for Performing an AFT with Visa
You can include these optional fields in an authorization request for an AFT:
- orderInformation.amountDetails.foreignExchangeFee
- This field is supported only for cross-border transactions. A cross-border transaction is a transaction for which the payment card is issued in one country and accepted by a merchant in another country.
- orderInformation.billTo.locality
- processingInformation.commerceIndicator
- Set this field tointernet,MOTO, or a 3D-Secure value.
- recipientInformation.lastName
- recipientInformation.middleName
- senderInformation.lastName
Related Information
REST Example: Performing an AFT with Visa
Request: Authorization Service for an AFT with Visa
Visa Example: Consumer funding an account-to account transfer
when the sender and recipient are the same person.
{ "clientReferenceInformation": { "code": "RTS-AFT3-8" }, "processingInformation": { "capture": true, "businessApplicationId": "AA", "commerceIndicator": "vbv", "authorizationOptions": { "ignoreAvsResult": true, "ignoreCvResult": false, "aftIndicator": true } }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "03", "expirationYear": "2025", "type": "001", "securityCode": "351" } }, "orderInformation": { "amountDetails": { "totalAmount": "28.00", "currency": "GBP" }, "billTo": { "firstName": "Joe", "lastName": "Root", "middleName": "S", "address1": "34 Orchard Grove", "locality": "Southampton", "postalCode": "DE6 1BE", "country": "GB", "email": "test@cybs.com" } }, "senderInformation": { "firstName": "Joe", "lastName": "Root", "middleName": "S", "address1": "34 Orchard Grove", "locality": "Southampton", "countryCode": "GB" }, "recipientInformation": { "accountId": "4929421234600821", "firstName": "Ben", "lastName": "Stokes", "middleName": "A" }, "consumerAuthenticationInformation": { "cavv": "EHuWW9PiBkWvqE5juRwDzAUFBAk=", "paresStatus": "Y" } }
Response: Authorization Service for an AFT with Visa
{ "_links": { "void": { "method": "POST", "href": "/pts/v2/payments/7285727331066440604951/voids" }, "self": { "method": "GET", "href": "/pts/v2/payments/7285727331066440604951" } }, "clientReferenceInformation": { "code": "RTS-AFT3-8" }, "id": "7285727331066440604951", "orderInformation": { "amountDetails": { "totalAmount": "28.00", "authorizedAmount": "28.00", "currency": "GBP" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "90011645" }, "processorInformation": { "merchantNumber": "6637599", "approvalCode": "475034", "cardVerification": { "resultCodeRaw": "1", "resultCode": "P" }, "merchantAdvice": { "code": "00", "codeRaw": "0" }, "networkTransactionId": "000000000474740", "transactionId": "000000000474740", "responseCode": "0", "avs": { "code": "I", "codeRaw": "11" } }, "reconciliationId": "7024464528", "status": "AUTHORIZED", "submitTimeUtc": "2024-10-10T15:05:35Z" }
Process an AFT with a Mastercard
Payouts
uses the authorization service to support AFTs. An
AFT withdraws funds from a sender’s account.IMPORTANT
You must receive prior approval from before using the AFT
services. Contact to register with the AFT program.
Barclays
Barclays
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/paymentsTest:
POST
https://apitest.cybersource.com
/pts/v2/paymentsRequired Fields for Performing an AFT with Mastercard
These fields are required in a request for an authorization for an AFT:
- Set totrue.
- These are the values when using a Mastercard card type. TherecipientInformation.accountTypefield must align with Business Application Identifier value.
- AA: Account-to-account, sender and recipient are the same person.recipientInformation.accountTypemust be either 01, 02, 03 or 06
- FT: Funds transfer where OCT not available. TherecipientInformation.accountTypemust be either 00, 01, 02, 03 or 06.
- PD: Payroll disbursement. TherecipientInformation.accountTypefield must be 03.
- TU: Top up - prepaid load. TherecipientInformation.accountTypefield must be either 01, 02, 03 or 06.
- WT: When AFT is used to fund a staged digital wallet. TherecipientInformation.accountTypemust be either 00, 01, 02, 03, 06 or absent.
- Only these codes are permitted with Mastercard:
- 00: Other
- 01: Routing transit number (RTM) and bank account
- 02: IBAN
- 03: Card account
- 06: Bank account number (BAN) and Bank identification number code (BIC)
Related Information
Optional Fields for Performing an AFT with Mastercard
You can include these optional fields in an authorization request for an AFT:
- orderInformation.amountDetails.foreignExchangeFee
- This field is supported only for cross-border transactions. A cross-border transaction is a transaction for which the payment card is issued in one country and accepted by a merchant in another country.
- orderInformation.amountDetails.serviceFeeAmount
- This field is supported only for cross-border transactions. A cross-border transaction is a transaction for which the payment card is issued in one country and accepted by a merchant in another country.
- orderInformation.billTo.locality
- processingInformation.commerceIndicator
- Set this field tointernet,MOTO, or a 3D-Secure value.
- recipientInformation.lastName
- recipientInformation.middleName
- senderInformation.locality
- senderInformation.middleName
REST Example: Performing an AFT with Mastercard
Request: Authorization Service for an AFT with Mastercard
Mastercard Example: Consumer funding an account-to-account
transfer when the sender and recipient are the same person.
{ "clientReferenceInformation": { "code": "RTS-AFT3-8" }, "processingInformation": { "capture": true, "businessApplicationId": "AA", "commerceIndicator": "spa", "authorizationOptions": { "ignoreAvsResult": true, "ignoreCvResult": false, "aftIndicator": true } }, "paymentInformation": { "card": { "number": "5454545454545454", "expirationMonth": "03", "expirationYear": "2025", "type": "002", "securityCode": "351" } }, "orderInformation": { "amountDetails": { "totalAmount": "28.00", "currency": "GBP" }, "billTo": { "firstName": "Joe", "lastName": "Root", "middleName": "S", "address1": "34 Orchard Grove", "locality": "Southampton", "postalCode": "DE6 1BE", "country": "GB", "email": "test@cybs.com" } }, "senderInformation": { "firstName": "Joe", "lastName": "Root", "middleName": "S", "address1": "34 Orchard Grove", "locality": "Southampton", "countryCode": "GB" }, "recipientInformation": { "accountId": "4929421234600821", "accountType": "03", "firstName": "Ben", "lastName": "Stokes", "middleName": "A", "address1": "1 High Street", "country": "GB" }, "consumerAuthenticationInformation": { "ucafAuthenticationData": "EHuWW9PiBkWvqE5juRwDzAUFBAk=", "ucafCollectionIndicator": "2" } }
Response: Authorization Service for an AFT with Mastercard
{ "_links": { "void": { "method": "POST", "href": "/pts/v2/payments/7285727331066440604951/voids" }, "self": { "method": "GET", "href": "/pts/v2/payments/7285727331066440604951" } }, "clientReferenceInformation": { "code": "RTS-AFT3-8" }, "id": "7285727331066440604951", "orderInformation": { "amountDetails": { "totalAmount": "28.00", "authorizedAmount": "28.00", "currency": "GBP" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "pointOfSaleInformation": { "terminalId": "90011645" }, "processorInformation": { "merchantNumber": "6637599", "approvalCode": "475034", "cardVerification": { "resultCodeRaw": "1", "resultCode": "P" }, "merchantAdvice": { "code": "00", "codeRaw": "0" }, "networkTransactionId": "000000000474740", "transactionId": "000000000474740", "responseCode": "0", "avs": { "code": "I", "codeRaw": "11" } }, "reconciliationId": "7024464528", "status": "AUTHORIZED", "submitTimeUtc": "2024-10-10T15:05:35Z" }
Original Credit Transactions (OCTs)
Original Credit Transactions deliver funds to a recipient's eligible accounts in real-time. OCTs are the second step in transferring funds
from an sender to a receiver.
Original Credit Transactions (OCTs)
An OCT deposits funds into a recipient’s account.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payoutsTest:
POST
https://apitest.cybersource.com
/pts/v2/payoutsRequired Fields for an OCT
These fields are required in a request for an OCT:
Related Information
REST Example: OCT Request
Request: Authorization Service for an OCT
{ "clientReferenceInformation":{ "code":"123456789" }, "orderInformation":{ "amountDetails":{ "totalAmount":"100.00", "currency":"USD" } }, "processingInformation":{ "businessApplicationId":"FD" }, "paymentInformation":{ "card":{ "number":"4111111111111111", "expirationMonth":"12", "expirationYear":"2025" } } }
Response: Authorization Service for an OCT
{ "clientReferenceInformation": { "code": "123456789" }, "id": "6213507771386164004005", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processorInformation": { "approvalCode": "100", "responseCode": "0" }, "status": "ACCEPTED", "submitTimeUtc": "2021-05-18T151257Z" }
Reference Information
This section provides helpful reference information for using
Payouts
services.Business Application Identifier
The Business Application Identifier (BAI) identifies the category of the Account Funding
Transaction (AFT).
All acquirers, service providers, and merchants must submit a valid BAI value when
submitting an AFT.
Provide one of the values when you send field .
processingInformation.businessApplicationId
IMPORTANT
Ensure that your acquirer has a Merchant
Category Code (MCC) that corresponds with the BAI value you are using. For more
information, contact your acquirer.
BAI Value | Category | Requirements |
|---|---|---|
AA | Account-to-Account Money transfer. This value is for funding the
cardholder's own account at the same or a different financial
institution. Both accounts must be owned by the same person or
entity. | IMPORTANT
If funding a prepaid account, do not use this
value. Use TU instead.For Mastercard transactions, the
recipientInformation.accountType field must
match the BAI value and must be either 01 ,
02 , 03 , or
06 . |
FT | Funds Transfer | If the funds will be used for a high-brand
risk transaction, the applicable high-brand risk MCC must be used. If a
wallet is used to purchase Liquid and Cryptocurrency assets, the
applicable special condition indicator must be used. For Mastercard transactions, the
recipientInformation.accountType field must
match the BAI value and must be either 00 ,
01 , 02 , 03 ,
or 06 . |
PD | Payroll Disbursement | For Mastercard transactions, the
recipientInformation.accountType field must
match the BAI value and must be 06 . |
TU | Prepaid Card Load or Top-Up | For Mastercard transactions, the
recipientInformation.accountType field must
match the BAI value and must be either 01, 02, 03, or 06. |
WT | Staged Digital Wallet (SDW)
Transfer | If the funds will be used for a high-brand
risk transaction, the applicable high-brand risk MCC must be used. If
the funds are used for a gambling transaction, the applicable gambling
MCC must be used. If a wallet is used to purchase Liquid and
Cryptocurrency assets, the applicable special condition indicator must
be used. An AFT is not intended for debt repayment. For Mastercard transactions, the
recipientInformation.accountType field must
match the BAI value and must be either 00 ,
01 , 02 , 03 ,
06 , or absent. |
Recipient Account
The Sender Source field identifies the source of funds. Provide one of the values when
you send field .
recipientInformation.accountType
Value | Definition |
|---|---|
00 | Other |
01 | RNT and Bank Account |
02 | IBAN |
03 | Card Account |
06 | Bank account number (BAN) and Bank
Identification Code (BIC) |
Original Credit Transactions
The Original Credit Transaction (OCT) is a transaction
that delivers funds directly to a recipient's eligible Visa card. You cannot use OCTs
alone to buy goods or services, except in Request to Pay Consumer-to-Small-Business
(C2B) cases. OCTs do not allow merchandise return credits or refunds, except by
exception or according to Visa rule #0008771.
IMPORTANT
You must differentiate between OCT processing
and merchandise credit refund processing. If you do not, it could lead to issues such as
the reversal of reward points.
These are some of the OCT services:
- Money Transfer
- Funds Disbursement
- Merchant Settlement
- Digital Wallets
- Real-Time Deposit/Check Deposit
- Loyalty and Offers
- Prepaid Load
- Credit Card Bill Payment
Money Transfer
Money transfers enable customers to send funds to their Visa account or another
customer's Visa account.
Funds Disbursement
Fund disbursements enable government entities or corporations to send funds to a Visa
account, such as:
- Insurance claims
- Corporate and manufacturing rebates
- Affiliate and contractor payouts
- Expense reimbursements
- Government disbursements (such as value-added tax refunds)
- Online gambling and lottery payouts.
IMPORTANT
Fund disbursement availability is dependent
on your country's and region's laws, current Visa policy, and the Visa rules.
Merchant Settlement
This services allows acquirers or third-party service providers to speed up
settlement payments between acquirers or payment facilitators and you.
Digital Wallets
This service enables faster payments through digital or electronic wallet services.
You can move funds out of a digital wallet and deliver them to a cardholder's Visa
account. This is considered a Money Transfer transaction for risk-control purposes
in the Visa processing network. A Staged Digital Wallet (SDW) functions as a brand
acceptance mark.
IMPORTANT
Contact your Visa representative for more
information and requirements on digital wallets. For more details on digital wallet
transactions, visit the Staged Digital Wallet Operators (SDWO) section at Visa
Access (Visa Online).
Real-Time Deposit/Check Deposit
This service converts a check into a digital payment delivered to a cardholder's Visa
account.
Loyalty and Offers
This service pays a loyalty reward or merchant offer onto a card using OCT as part of
a loyalty program.
Prepaid Load
This service enables customers to add value to an eligible Visa reloadable prepaid
card.
IMPORTANT
The US market currently supports a separate
prepaid load service called Visa ReadyLink. For more information on Visa ReadyLink,
contact your Visa representative.
Credit Card Bill Payment
This service enables consumers to pay a credit card bill.
IMPORTANT
When using OCT supported by Visa Direct,
you can only use Visa data, like transaction data, reports, and the Visa Direct
Account Lookup (ACNL), to operate the Visa program. You cannot use this data for any
other purpose.
Visa Card Types and Services for OCTs
Visa card types include reloadable prepaid, deferred debit, debit, credit, and combo
cards, each with specific OCT functionalities. OCTs can increase balances or serve as
payments, depending on the card type and account setup. These services apply to both
domestic and cross-border transactions, supporting money transfers, funds disbursement,
prepaid loads, and credit card bill payments.
Visa Card Types
These are the different Visa card types, descriptions, and examples:
- Visa Reloadable Prepaid
- An OCT to an eligible Visa prepaid card increases the prepaid card balance.
- If the prepaid card balance is 25 USD and the OCT received is for 100 USD, the new prepaid balance is 125 USD.
- Visa Deferred Debit
- Deferred Debit cards have a line of credit and an underlying bank account. An OCT to a Visa Deferred Debit card deposits funds into the underlying account when both the line of credit and underlying account are with the same bank. If the Deferred Debit card underlying account is with a different bank than the line of credit, post the funds to the card account.
- If the underlying account has a balance of 800 USD and an OCT for 100 USD is received to the card, the new account balance is 900 USD. The credit balance owed on the card is not impacted by the receipt of the OCT. If the card has a balance owed of 200 USD and an OCT for 100 USD is received, the payment of USD 100 will be posted to the credit account. The new outstanding balance would be USD 100.
- Visa Debit
- An OCT to a Visa debit card increases the balance of the underlying bank account associated with the Visa debit card.
- If the card balance is 800 USD and the OCT received is for 100 USD, the new account balance is 900 USD.
- Visa Credit
- An OCT to a Visa credit card serves as a payment to the account.
- If the amount owed on the card is 800 USD and an OCT for 100 USD is received to the card, a payment of USD 100 will be posted to the account. The new outstanding balance is 700 USD.
- Visa Combo Card (Brazil)
- Combo cards allow cardholders to use credit or debit functionality during a transaction. An OCT to a Visa Combo card processed as debit increases the balance of the underlying deposit account linked to the card.
- The credit balance owed on the card is not impacted by the receipt of the OCT. Funds are applied only to the debit balance in the deposit account. Do not present the OCT for combo cards as credit using the proper values.
- If the deposit account linked to the card has a balance of 800 USD, and an OCT for 100 USD is received to the account, the new account balance is USD 900.
OCT Services
See the table for an overview of Visa's Original Credit Transaction (OCT) services,
key features and benefits:
OCT Services | Destination Visa Account Types Visa Credit | Destination Visa Account Types Visa Debit | Destination Visa Account Types Visa Prepaid | Geographic Scope Domestic | Geographic Scope Cross-Border |
|---|---|---|---|---|---|
Money Transfer (includes digital wallet and instant
deposits) | X | X | X | X | X |
Funds Disbursement (includes merchant settlement and Loyalty and
Offers) | X | X | X | X | X |
Prepaid Load | X | X | |||
Credit Card Bill Payment | X | X |
Identifying Domestic and Cross-Border OCTs
Identifying Domestic and Cross-Border OCTs
Visa defines a transaction as domestic when you, the acquirer, and the recipient
issuer are all in the same country. If the recipient issuer is in a different
country from you or the acquirer, the transaction becomes a cross-border
transaction.
In the European Economic Area (EEA), Visa uses different
definitions for domestic and cross-border transactions for internal risk management
of Original Credit Transactions (OCTs) compared to countries outside the EEA.
Therefore, do not interpret the definitions in the domestic versus cross-border
definition table as legal advice from
Visa
.
Acquirers and recipient issuers must seek their own legal advice on their legal and
regulatory obligations in the EEA.The EEA domestic versus cross-border
definitions apply to:
- Visa’s default velocity limits and recipient issuer’s custom velocity limits
- Data requirements to process an OCT (for details see Appendix A ofOriginal Credit Transaction Data Elements and Processing Rules)
- Use case restrictions (prepaid load and credit card bill payment)
The domestic vs. cross-border definition table explains domestic and
cross-border OCT transactions within the European Economic Area (EEA) regions, UK
(and Gibraltar, where relevant), and outside EEA.
Domestic vs. Cross-Border Definition
Geographic Scope | European Economic Area (EEA), UK, and
Gibraltar (where relevant) Money Transfer | European Economic Area (EEA), UK, and
Gibraltar (where relevant) Funds Disbursement/Non-Money
Transfer | Outside EEA |
|---|---|---|---|
Domestic |
Example: Person-to-person Money Transfer between two
people in Germany |
Example: Funds Disbursement between a merchant and a
person in Germany | You, the acquirer, and recipient issuer are in the same
country. |
Cross-border | Anything that does not meet the Domestic Money Transfer
definition is considered cross-border Example: Person-to-person Money Transfer between a sender
in Spain and a recipient in France | Anything that does not meet the Domestic Funds
Disbursement/Non-Money Transfer definition is considered
cross-border Example: Funds Disbursement from a merchant in Spain to a
recipient in Malta | Recipient issuer is in a different country than you or the
acquirer. |
Process an OCT
Original Credit Transactions (OCTs) deliver funds to a recipient's
eligible accounts in real-time. OCTs are the second step in transferring funds from an
sender to a receiver.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payoutsTest:
POST
https://apitest.cybersource.com
/pts/v2/payoutsRequired Fields for an OCT
REST Example: OCT Request
Request: Authorization Service for an OCT
{ "clientReferenceInformation":{ "code":"123456789" }, "orderInformation":{ "amountDetails":{ "totalAmount":"100.00", "currency":"USD" } }, "processingInformation":{ "businessApplicationId":"FD" }, "paymentInformation":{ "card":{ "number":"411111111111111", "expirationMonth":"12", "expirationYear":"2025" } } }
Response: Authorization Service for an OCT
{ "clientReferenceInformation": { "code": "123456789" }, "id": "6213507771386164004005", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processorInformation": { "approvalCode": "100", "responseCode": "0" }, "status": "ACCEPTED", "submitTimeUtc": "2021-05-18T151257Z" }