{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/SubmitRequest", "title": "SubmitRequest", "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" }, "dateOfBirth": { "x-addedInVersion": "24", "description": "The date of birth.\nFormat: ISO-8601; example: YYYY-MM-DD\n\nFor Paysafecard it must be the same as used when registering the Paysafecard account.\n\n> This field is mandatory for natural persons. \n> This field is required to update the existing `dateOfBirth` that is associated with this recurring contract.", "format": "date", "type": "string" }, "entityType": { "x-addedInVersion": "24", "description": "The type of the entity the payout is processed for.\n\nAllowed values:\n* NaturalPerson\n* Company\n> This field is required to update the existing `entityType` that is associated with this recurring contract.", "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 you want to process the transaction request with.", "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').\n\n> This field is required to update the existing nationality that is associated with this recurring contract.", "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 payout. 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" }, "selectedRecurringDetailReference": { "description": "This is the `recurringDetailReference` you want to use for this payout.\n\nYou can use the value LATEST to select the most recently used recurring detail.", "type": "string" }, "shopperEmail": { "description": "The shopper's email address.", "type": "string" }, "shopperName": { "x-addedInVersion": "24", "description": "The shopper's name.\n\nIn case the `entityType` is `Company`, the `shopperName.lastName` must contain the company name.\n\n> This field is required to update the existing `shopperName` associated with a recurring contract.", "$ref": "#/components/schemas/Name" }, "shopperReference": { "description": "The shopper's reference for the payout 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" } }, "required": [ "merchantAccount", "reference", "amount", "shopperEmail", "shopperReference", "recurring", "selectedRecurringDetailReference" ], "type": "object" }