{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/PayoutRequest", "title": "PayoutRequest", "properties": { "amount": { "description": "The amount information for the transaction (in [minor units](https://docs.adyen.com/development-resources/currency-codes)). For [BIN or card verification](https://docs.adyen.com/payment-methods/cards/bin-data-and-card-verification) requests, set amount to 0 (zero).", "$ref": "#/components/schemas/Amount" }, "billingAddress": { "x-addedInVersion": "4", "description": "The address where to send the invoice.\n> The `billingAddress` object is required in the following scenarios. Include all of the fields within this object.\n>* For 3D Secure 2 transactions in all browser-based and mobile implementations.\n>* For cross-border payouts to and from Canada.", "$ref": "#/components/schemas/Address" }, "card": { "description": "A container for card data.\n> Either `bankAccount` or `card` field must be provided in a payment request.", "$ref": "#/components/schemas/Card" }, "fraudOffset": { "description": "An integer value that is added to the normal fraud score. The value can be either positive or negative.", "format": "int32", "type": "integer" }, "fundSource": { "x-addedInVersion": "64", "description": "The person or entity funding the money.", "$ref": "#/components/schemas/FundSource" }, "merchantAccount": { "description": "The merchant account identifier, with which you want to process the transaction.", "type": "string" }, "recurring": { "description": "The recurring settings for the payment. Use this property when you want to enable [recurring payments](https://docs.adyen.com/classic-integration/recurring-payments).", "$ref": "#/components/schemas/Recurring" }, "reference": { "description": "The reference to uniquely identify a payment. This reference is used in all communication with you about the payment status. We recommend using a unique value per payment; however, it is not a requirement.\nIf you need to provide multiple references for a transaction, separate them with hyphens (\"-\").\nMaximum length: 80 characters.", "type": "string" }, "selectedRecurringDetailReference": { "description": "The `recurringDetailReference` you want to use for this payment. The value `LATEST` can be used to select the most recently stored recurring detail.", "type": "string" }, "shopperEmail": { "description": "The shopper's email address. We recommend that you provide this data, as it is used in velocity fraud checks.\n> For 3D Secure 2 transactions, schemes require `shopperEmail` for all browser-based and mobile implementations.", "type": "string" }, "shopperInteraction": { "description": "Specifies the sales channel, through which the shopper gives their card details, and whether the shopper is a returning customer.\nFor the web service API, Adyen assumes Ecommerce shopper interaction by default.\n\nThis field has the following possible values:\n* `Ecommerce` - Online transactions where the cardholder is present (online). For better authorisation rates, we recommend sending the card security code (CSC) along with the request.\n* `ContAuth` - Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer). If the shopper is present (online), you can supply also the CSC to improve authorisation (one-click payment).\n* `Moto` - Mail-order and telephone-order transactions where the shopper is in contact with the merchant via email or telephone.\n* `POS` - Point-of-sale transactions where the shopper is physically present to make a payment using a secure payment terminal.", "enum": [ "Ecommerce", "ContAuth", "Moto", "POS" ], "type": "string" }, "shopperName": { "x-addedInVersion": "7", "description": "The shopper's full name.", "$ref": "#/components/schemas/Name" }, "shopperReference": { "description": "Required for recurring payments. \nYour reference to uniquely identify this shopper, for example user ID or account ID. Minimum length: 3 characters.\n> Your reference must not include personally identifiable information (PII), for example name or email address.", "type": "string" }, "telephoneNumber": { "x-addedInVersion": "7", "description": "The shopper's telephone number.", "type": "string" } }, "required": [ "merchantAccount", "reference", "amount" ], "type": "object" }