Adyen · Schema

StoreDetailAndSubmitRequest

PaymentsFinancial ServicesFintech

Properties

Name Type Description
additionalData object This field contains additional data, which may be required for a particular request.
amount object A container object for the payable amount information of the transaction.
bank object A container for bank account data. > This field is mandatory if `card` is not provided.
billingAddress object The billing address. > The `billingAddress` object is required for cross-border payouts to and from Canada. Include all of the fields within this object.
card object A container for card data. > This field is mandatory if `bank` is not provided.
dateOfBirth string The date of birth. Format: [ISO-8601](https://www.w3.org/TR/NOTE-datetime); example: YYYY-MM-DD For Paysafecard it must be the same as used when registering the Paysafecard account. > This field is ma
entityType string The type of the entity the payout is processed for.
fraudOffset integer An integer value that is added to the normal fraud score. The value can be either positive or negative.
merchantAccount string The merchant account identifier, with which you want to process the transaction.
nationality string The shopper's nationality. A valid value is an ISO 2-character country code (e.g. 'NL').
recurring object A container for the type of recurring contract to be retrieved. The recurring.contract must be set to `PAYOUT`
reference string The merchant reference for this payment. This reference will be used in all communication to the merchant about the status of the payout. Although it is a good idea to make sure it is unique, this is
selectedBrand string The name of the brand to make a payout to. For Paysafecard it must be set to `paysafecard`.
shopperEmail string The shopper's email address.
shopperName object The shopper's name. When the `entityType` is `Company`, the `shopperName.lastName` must contain the company name.
shopperReference string The shopper's reference for the payment transaction.
shopperStatement string The description of this payout. This description is shown on the bank statement of the shopper (if this is supported by the chosen payment method).
socialSecurityNumber string The shopper's social security number.
telephoneNumber string The shopper's phone number.
View JSON Schema on GitHub

JSON Schema

adyen-storedetailandsubmitrequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/StoreDetailAndSubmitRequest",
  "title": "StoreDetailAndSubmitRequest",
  "properties": {
    "additionalData": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "This field contains additional data, which may be required for a particular request.",
      "type": "object"
    },
    "amount": {
      "description": "A container object for the payable amount information of the transaction.",
      "$ref": "#/components/schemas/Amount"
    },
    "bank": {
      "description": "A container for bank account data.\n> This field is mandatory if `card` is not provided.",
      "$ref": "#/components/schemas/BankAccount"
    },
    "billingAddress": {
      "x-addedInVersion": "18",
      "description": "The billing address.\n\n> The `billingAddress` object is required for cross-border payouts to and from Canada. Include all of the fields within this object.",
      "$ref": "#/components/schemas/Address"
    },
    "card": {
      "description": "A container for card data.\n> This field is mandatory if `bank` is not provided.",
      "$ref": "#/components/schemas/Card"
    },
    "dateOfBirth": {
      "x-addedInVersion": "24",
      "description": "The date of birth.\nFormat: [ISO-8601](https://www.w3.org/TR/NOTE-datetime); example: YYYY-MM-DD\nFor Paysafecard it must be the same as used when registering the Paysafecard account.\n> This field is mandatory for natural persons.",
      "format": "date",
      "type": "string"
    },
    "entityType": {
      "x-addedInVersion": "24",
      "description": "The type of the entity the payout is processed for.",
      "enum": [
        "NaturalPerson",
        "Company"
      ],
      "type": "string"
    },
    "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"
    },
    "merchantAccount": {
      "description": "The merchant account identifier, with which you want to process the transaction.",
      "type": "string"
    },
    "nationality": {
      "x-addedInVersion": "24",
      "description": "The shopper's nationality.\n\nA valid value is an ISO 2-character country code (e.g. 'NL').",
      "maxLength": 2,
      "type": "string"
    },
    "recurring": {
      "description": "A container for the type of recurring contract to be retrieved.\n\nThe recurring.contract must be set to `PAYOUT`",
      "$ref": "#/components/schemas/Recurring"
    },
    "reference": {
      "description": "The merchant reference for this payment. This reference will be used in all communication to the merchant about the status of the payout. Although it is a good idea to make sure it is unique, this is not a requirement.",
      "type": "string"
    },
    "selectedBrand": {
      "x-addedInVersion": "24",
      "description": "The name of the brand to make a payout to.\n\nFor Paysafecard it must be set to `paysafecard`.",
      "type": "string"
    },
    "shopperEmail": {
      "description": "The shopper's email address.",
      "type": "string"
    },
    "shopperName": {
      "x-addedInVersion": "24",
      "description": "The shopper's name.\n\nWhen the `entityType` is `Company`, the `shopperName.lastName` must contain the company name.",
      "$ref": "#/components/schemas/Name"
    },
    "shopperReference": {
      "description": "The shopper's reference for the payment transaction.",
      "type": "string"
    },
    "shopperStatement": {
      "x-addedInVersion": "2",
      "description": "The description of this payout. This description is shown on the bank statement of the shopper (if this is supported by the chosen payment method).",
      "type": "string"
    },
    "socialSecurityNumber": {
      "x-addedInVersion": "24",
      "description": "The shopper's social security number.",
      "type": "string"
    },
    "telephoneNumber": {
      "x-addedInVersion": "52",
      "description": "The shopper's phone number.",
      "type": "string"
    }
  },
  "required": [
    "merchantAccount",
    "shopperEmail",
    "shopperReference",
    "recurring",
    "dateOfBirth",
    "nationality",
    "entityType",
    "reference",
    "amount"
  ],
  "type": "object"
}