mirror of
https://github.com/gcatanese/adyen-openapi.git
synced 2026-03-10 08:01:24 +00:00
2656 lines
120 KiB
JSON
2656 lines
120 KiB
JSON
{
|
|
"openapi" : "3.0.3",
|
|
"servers" : [
|
|
{
|
|
"url" : "https://cal-test.adyen.com/cal/services/Account/v5"
|
|
}
|
|
],
|
|
"info" : {
|
|
"version" : "5",
|
|
"title" : "Adyen for Platforms: Account API",
|
|
"description" : "The Account API provides endpoints for managing account-related entities on your platform. These related entities include account holders, accounts, bank accounts, shareholders, and KYC-related documents. The management operations include actions such as creation, retrieval, updating, and deletion of them.\n\nFor more information, refer to our [documentation](https://docs.adyen.com/platforms).\n## Authentication\nTo connect to the Account API, you must use basic authentication credentials of your web service user. If you don't have one, please contact the [Adyen Support Team](https://support.adyen.com/hc/en-us/requests/new). Then use its credentials to authenticate your request, for example:\n\n```\ncurl\n-U \"ws@MarketPlace.YourMarketPlace\":\"YourWsPassword\" \\\n-H \"Content-Type: application/json\" \\\n...\n```\nNote that when going live, you need to generate new web service user credentials to access the [live endpoints](https://docs.adyen.com/development-resources/live-endpoints).\n\n## Versioning\nThe Account API supports versioning of its endpoints through a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://cal-test.adyen.com/cal/services/Account/v5/createAccountHolder\n```",
|
|
"termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
|
|
"contact" : {
|
|
"name" : "Adyen Support",
|
|
"url" : "https://support.adyen.com/",
|
|
"email" : "support@adyen.com"
|
|
}
|
|
},
|
|
"x-groups" : [
|
|
"Account holders",
|
|
"Accounts",
|
|
"Verification"
|
|
],
|
|
"paths" : {
|
|
"/checkAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Request to perform verification for an account holder.",
|
|
"description" : "This endpoint allows to trigger the verification of the account holder earlier than it's required by the currently processed volume.",
|
|
"operationId" : "post-checkAccountHolder",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 5,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/PerformVerificationRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GenericResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/closeAccount" : {
|
|
"post" : {
|
|
"summary" : "Close an existing account under an account holder.",
|
|
"description" : "This endpoint is used to close an existing account under an account holder. If an account is closed, it may not process transactions or have its funds paid out,and it may not be reopened. Any payments made to a closed account will be directed to the merchant's liable account.",
|
|
"operationId" : "post-closeAccount",
|
|
"x-groupName" : "Accounts",
|
|
"x-sortIndex" : 3,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CloseAccountRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CloseAccountResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/closeAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Close an existing account holder.",
|
|
"description" : "This endpoint is used to close an existing account holder and its accounts. If an account holder is closed, it may not process transactions or pay out funds, and it may not be reopened. Any payments made to a closed account will be directed to the merchant's liable account.",
|
|
"operationId" : "post-closeAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 7,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CloseAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CloseAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/createAccount" : {
|
|
"post" : {
|
|
"summary" : "Create a new account under an existing account holder.",
|
|
"description" : "This endpoint is used to create an account under an existing account holder. An account holder may have multiple accounts.",
|
|
"operationId" : "post-createAccount",
|
|
"x-groupName" : "Accounts",
|
|
"x-sortIndex" : 1,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CreateAccountRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CreateAccountResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/createAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Create a new account holder.",
|
|
"description" : "This endpoint is used to create an account holder. Each account holder represents a single sub-merchant, and each sub-merchant must be represented by an account holder. Depending on the legal entity type, different details are required to be provided in the call to this endpoint.",
|
|
"operationId" : "post-createAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 1,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CreateAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/CreateAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/deleteBankAccounts" : {
|
|
"post" : {
|
|
"summary" : "Delete bank accounts of an existing account holder.",
|
|
"description" : "This endpoint is used to delete existing bank accounts from an account holder. For this, pass the `accountHolderCode` you got on the account holder creation, and one or more `bankAccountUUIDs` specifying bank accounts to delete.",
|
|
"operationId" : "post-deleteBankAccounts",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 3,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/DeleteBankAccountRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GenericResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/deletePayoutMethods" : {
|
|
"post" : {
|
|
"summary" : "Delete payout methods of an existing account holder.",
|
|
"description" : "This endpoint is used to delete existing payout method from an account holder. For this, pass the `accountHolderCode` you got on the account holder creation, and one or more `payoutMethodCodes` specifying payout methods to delete.",
|
|
"operationId" : "post-deletePayoutMethods",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 3,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/DeletePayoutMethodRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GenericResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/deleteShareholders" : {
|
|
"post" : {
|
|
"summary" : "Delete shareholders of an existing account holder.",
|
|
"description" : "This endpoint is used to delete existing shareholders from an account holder.",
|
|
"operationId" : "post-deleteShareholders",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 4,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/DeleteShareholderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GenericResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/getAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Retrieve the details of an account holder.",
|
|
"description" : "This endpoint is used to retrieve the details of an account holder.",
|
|
"operationId" : "post-getAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 2,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GetAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GetAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/getUploadedDocuments" : {
|
|
"post" : {
|
|
"summary" : "Retrieve the uploaded documents of an existing account holder.",
|
|
"description" : "This endpoint is used to retrieve documents previously uploaded for use in the KYC Verification of an account holder.\n\nFor further information regarding KYC Verification, please refer to [Verification checks](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks).",
|
|
"operationId" : "post-getUploadedDocuments",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 2,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GetUploadedDocumentsRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GetUploadedDocumentsResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/suspendAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Suspend an existing account holder.",
|
|
"description" : "This endpoint is used to suspend an existing account holder. If an account holder is suspended, it may not process transactions or pay out funds. Any payments made to a suspended account holder will be directed to the merchant's liable account.",
|
|
"operationId" : "post-suspendAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 5,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/SuspendAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/SuspendAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/unSuspendAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Reinstate a disabled account holder.",
|
|
"description" : "This endpoint is used to reinstate an existing account holder, which has been suspended through the `/suspendAccountHolder` endpoint. An account holder which has been suspended due to KYC verification issues cannot be reinstated through this endpoint.",
|
|
"operationId" : "post-unSuspendAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 6,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UnSuspendAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UnSuspendAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/updateAccount" : {
|
|
"post" : {
|
|
"summary" : "Update an existing account under an account holder.",
|
|
"description" : "This endpoint is used to update the description or payout schedule of an existing account.",
|
|
"operationId" : "post-updateAccount",
|
|
"x-groupName" : "Accounts",
|
|
"x-sortIndex" : 2,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/updateAccountHolder" : {
|
|
"post" : {
|
|
"summary" : "Update an existing account holder.",
|
|
"description" : "This endpoint is used to update the `accountHolderDetails` or `processingTier` of an account holder.\n\nIf updating the `accountHolderDetails`, only the details which have been provided will be updated. Other details will be left as-is with the exception of the following fields:\n* `accountHolderDetails.address`\n* `accountHolderDetails.fullPhoneNumber`\n* `accountHolderDetails.bankAccountDetails.BankAccountDetail`\n* `accountHolderDetails.businessDetails.shareholders.ShareholderContact`, which requires all fields necessary for validation (i.e. in order to update only the `accountHolderDetails.address.postalCode`, the fields `accountHolderDetails.address.country`, `.city`, `.street`, `.postalCode`, and possibly `.stateOrProvince` must be provided as well, so that the address can be properly validated).\n\nNote that this endpoint can also be used to create new bank accounts. For this, provide details of a bank account without providing a `bankAccountUUID`.\n\nSimilarly, it can also be used to create new shareholders by providing details of a shareholder without providing a `shareholderCode`.\n> The updating of the `metadata` field will overwite all of the existing account holder metadata. In order to update an existing metadata key-value pair, all otherkey-value pairs should be provided in order to not delete them.",
|
|
"operationId" : "post-updateAccountHolder",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 3,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountHolderRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/updateAccountHolderState" : {
|
|
"post" : {
|
|
"summary" : "Update the state of an existing account holder.",
|
|
"description" : "This endpoint is used to disable or enable the processing or payout state of an account holder. It cannot be used to enable an account holder whose processing or payout state has not been disabled through this endpoint.\n\nFor more information about processing and payout states of an account holder, refer to [our documentation](https://docs.adyen.com/platforms).",
|
|
"operationId" : "post-updateAccountHolderState",
|
|
"x-groupName" : "Account holders",
|
|
"x-sortIndex" : 4,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountHolderStateRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/GetAccountHolderStatusResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/uploadDocument" : {
|
|
"post" : {
|
|
"summary" : "Upload a document for an existing account holder.",
|
|
"description" : "This endpoint is used to upload a document for use in the KYC verification of an account holder.\n\nFor further information regarding KYC Verification, please refer to [Verification checks](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks).",
|
|
"operationId" : "post-uploadDocument",
|
|
"x-groupName" : "Verification",
|
|
"x-sortIndex" : 1,
|
|
"requestBody" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UploadDocumentRequest"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses" : {
|
|
"200" : {
|
|
"content" : {
|
|
"application/json" : {
|
|
"schema" : {
|
|
"$ref" : "#/components/schemas/UpdateAccountHolderResponse"
|
|
}
|
|
}
|
|
},
|
|
"description" : "OK - the request has succeeded."
|
|
},
|
|
"400" : {
|
|
"description" : "Bad Request - a problem reading or understanding the request."
|
|
},
|
|
"422" : {
|
|
"description" : "Unprocessable Entity - a request validation error."
|
|
},
|
|
"401" : {
|
|
"description" : "Unauthorized - authentication required."
|
|
},
|
|
"500" : {
|
|
"description" : "Internal Server Error - the server could not process the request."
|
|
},
|
|
"403" : {
|
|
"description" : "Forbidden - insufficient permissions to process the request."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components" : {
|
|
"schemas" : {
|
|
"Account" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of the account.",
|
|
"type" : "string"
|
|
},
|
|
"beneficiaryAccount" : {
|
|
"description" : "The beneficiary of the account.",
|
|
"type" : "string"
|
|
},
|
|
"beneficiaryMerchantReference" : {
|
|
"description" : "The reason that a beneficiary has been set up for this account. This may have been supplied during the setup of a beneficiary at the discretion of the executing user.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "A description of the account.",
|
|
"type" : "string"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"description" : "A set of key and value pairs for general use by the merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
|
|
"type" : "object"
|
|
},
|
|
"payoutSchedule" : {
|
|
"description" : "The account's payout schedule.",
|
|
"$ref" : "#/components/schemas/PayoutScheduleResponse"
|
|
},
|
|
"payoutSpeed" : {
|
|
"description" : "Speed with which payouts for this account are processed. Permitted values: `STANDARD`, `SAME_DAY`.",
|
|
"enum" : [
|
|
"SAME_DAY",
|
|
"STANDARD"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"status" : {
|
|
"description" : "The status of the account. Possible values: `Active`, `Inactive`, `Suspended`, `Closed`.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"AccountEvent" : {
|
|
"properties" : {
|
|
"event" : {
|
|
"description" : "The event.\n>Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`.\nFor more information, refer to [Verification checks](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks).",
|
|
"enum" : [
|
|
"InactivateAccount",
|
|
"RefundNotPaidOutTransfers"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"executionDate" : {
|
|
"description" : "The date on which the event will take place.",
|
|
"format" : "date-time",
|
|
"type" : "string"
|
|
},
|
|
"reason" : {
|
|
"description" : "The reason why this event has been created.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"event",
|
|
"executionDate",
|
|
"reason"
|
|
]
|
|
},
|
|
"AccountHolderDetails" : {
|
|
"properties" : {
|
|
"address" : {
|
|
"description" : "The address of the account holder.",
|
|
"$ref" : "#/components/schemas/ViasAddress"
|
|
},
|
|
"bankAccountDetails" : {
|
|
"description" : "Each of the bank accounts associated with the account holder.\n> Each array entry should represent one bank account.\n> For comprehensive detail regarding the required `BankAccountDetail` fields, please refer to the [KYC Verification documentation](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks).",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/BankAccountDetail"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"bankAggregatorDataReference" : {
|
|
"description" : "The opaque reference value returned by the Adyen API during bank account login.",
|
|
"type" : "string"
|
|
},
|
|
"businessDetails" : {
|
|
"description" : "Details applicable to `Business` legal entities.\nPopulated only if the account holder's legal entity is of type `Business`.\n> Required when being used in a `/createAccountHolder` request in which the legal entity is `Business`.",
|
|
"$ref" : "#/components/schemas/BusinessDetails"
|
|
},
|
|
"email" : {
|
|
"description" : "The email address of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"fullPhoneNumber" : {
|
|
"description" : "The phone number of the account holder provided as a single string. It will be handled as a landline phone.\n**Examples:** \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
|
|
"type" : "string"
|
|
},
|
|
"individualDetails" : {
|
|
"description" : "Details applicable to `Individual` legal entities.\nPopulated only if the account holder's legal entity is of type `Individual`.\n> Required when being used in a `/createAccountHolder` request in which the legal entity is `Individual`.",
|
|
"$ref" : "#/components/schemas/IndividualDetails"
|
|
},
|
|
"merchantCategoryCode" : {
|
|
"description" : "The Merchant Category Code of the account holder.\n> If not specified in the request, this will be derived from the platform account (which is configured by Adyen).",
|
|
"type" : "string"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"description" : "A set of key and value pairs for general use by the account holder or merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> The values being stored have a maximum length of eighty (80) characters and will be truncated if necessary.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
|
|
"type" : "object"
|
|
},
|
|
"payoutMethods" : {
|
|
"description" : "Each of the card tokens associated with the account holder.\n> Each array entry should represent one card token.\n> For comprehensive detail regarding the required `CardToken` fields, please refer to the [KYC Verification documentation](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks).",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/PayoutMethod"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"webAddress" : {
|
|
"description" : "The URL of the website of the account holder.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"fullPhoneNumber",
|
|
"email",
|
|
"webAddress"
|
|
]
|
|
},
|
|
"AccountHolderStatus" : {
|
|
"properties" : {
|
|
"events" : {
|
|
"description" : "A list of events scheduled for the account holder.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/AccountEvent"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"payoutState" : {
|
|
"description" : "The payout state of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountPayoutState"
|
|
},
|
|
"processingState" : {
|
|
"description" : "The processing state of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountProcessingState"
|
|
},
|
|
"status" : {
|
|
"description" : "The status of the account holder.\n>Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.",
|
|
"enum" : [
|
|
"Active",
|
|
"Closed",
|
|
"Inactive",
|
|
"Suspended"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"statusReason" : {
|
|
"description" : "The reason why the status was assigned to the account holder.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"status"
|
|
]
|
|
},
|
|
"AccountPayoutState" : {
|
|
"properties" : {
|
|
"allowPayout" : {
|
|
"description" : "Indicates whether payouts are allowed. This field is the overarching payout status, and is the aggregate of multiple conditions (e.g., KYC status, disabled flag, etc). If this field is false, no payouts will be permitted for any of the account holder's accounts. If this field is true, payouts will be permitted for any of the account holder's accounts.",
|
|
"type" : "boolean"
|
|
},
|
|
"disableReason" : {
|
|
"description" : "The reason why payouts (to all of the account holder's accounts) have been disabled (by the platform). If the `disabled` field is true, this field can be used to explain why.",
|
|
"type" : "string"
|
|
},
|
|
"disabled" : {
|
|
"description" : "Indicates whether payouts have been disabled (by the platform) for all of the account holder's accounts. A platform may enable and disable this field at their discretion. If this field is true, `allowPayout` will be false and no payouts will be permitted for any of the account holder's accounts. If this field is false, `allowPayout` may or may not be enabled, depending on other factors.",
|
|
"type" : "boolean"
|
|
},
|
|
"notAllowedReason" : {
|
|
"description" : "The reason why payouts (to all of the account holder's accounts) have been disabled (by Adyen). If payouts have been disabled by Adyen, this field will explain why. If this field is blank, payouts have not been disabled by Adyen.",
|
|
"type" : "string"
|
|
},
|
|
"payoutLimit" : {
|
|
"description" : "The maximum amount that payouts are limited to. Only applies if payouts are allowed but limited.",
|
|
"$ref" : "#/components/schemas/Amount"
|
|
},
|
|
"tierNumber" : {
|
|
"description" : "The payout tier that the account holder occupies.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
}
|
|
}
|
|
},
|
|
"AccountProcessingState" : {
|
|
"properties" : {
|
|
"disableReason" : {
|
|
"description" : "The reason why processing has been disabled.",
|
|
"type" : "string"
|
|
},
|
|
"disabled" : {
|
|
"description" : "Indicates whether the processing of payments is allowed.",
|
|
"type" : "boolean"
|
|
},
|
|
"processedFrom" : {
|
|
"description" : "The lower bound of the processing tier (i.e., an account holder must have processed at least this amount of money in order to be placed into this tier).",
|
|
"$ref" : "#/components/schemas/Amount"
|
|
},
|
|
"processedTo" : {
|
|
"description" : "The upper bound of the processing tier (i.e., an account holder must have processed less than this amount of money in order to be placed into this tier).",
|
|
"$ref" : "#/components/schemas/Amount"
|
|
},
|
|
"tierNumber" : {
|
|
"description" : "The processing tier that the account holder occupies.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
}
|
|
}
|
|
},
|
|
"Amount" : {
|
|
"properties" : {
|
|
"currency" : {
|
|
"description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).",
|
|
"maxLength" : 3,
|
|
"minLength" : 3,
|
|
"type" : "string"
|
|
},
|
|
"value" : {
|
|
"description" : "The payable amount that can be charged for the transaction.\n\nThe transaction amount needs to be represented in minor units according to the [following table](https://docs.adyen.com/development-resources/currency-codes).",
|
|
"format" : "int64",
|
|
"type" : "integer"
|
|
}
|
|
},
|
|
"required" : [
|
|
"value",
|
|
"currency"
|
|
]
|
|
},
|
|
"BankAccountDetail" : {
|
|
"properties" : {
|
|
"accountNumber" : {
|
|
"description" : "The bank account number (without separators).\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"accountType" : {
|
|
"description" : "The type of bank account.\nOnly applicable to bank accounts held in the USA.\nThe permitted values are: `checking`, `savings`.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountName" : {
|
|
"description" : "The name of the bank account.",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountReference" : {
|
|
"description" : "Merchant reference to the bank account.",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountUUID" : {
|
|
"description" : "The unique identifier (UUID) of the Bank Account.\n>If, during an account holder create or update request, this field is left blank (but other fields provided), a new Bank Account will be created with a procedurally-generated UUID.\n\n>If, during an account holder create request, a UUID is provided, the creation of the Bank Account will fail while the creation of the account holder will continue.\n\n>If, during an account holder update request, a UUID that is not correlated with an existing Bank Account is provided, the update of the account holder will fail.\n\n>If, during an account holder update request, a UUID that is correlated with an existing Bank Account is provided, the existing Bank Account will be updated.\n",
|
|
"type" : "string"
|
|
},
|
|
"bankBicSwift" : {
|
|
"description" : "The bank identifier code.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"bankCity" : {
|
|
"description" : "The city in which the bank branch is located.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"bankCode" : {
|
|
"description" : "The bank code of the banking institution with which the bank account is registered.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"bankName" : {
|
|
"description" : "The name of the banking institution with which the bank account is held.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"branchCode" : {
|
|
"description" : "The branch code of the branch under which the bank account is registered. The value to be specified in this parameter depends on the country of the bank account:\n* United States - Routing number\n* United Kingdom - Sort code\n* Germany - Bankleitzahl\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"checkCode" : {
|
|
"description" : "The check code of the bank account.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"countryCode" : {
|
|
"description" : "The two-letter country code in which the bank account is registered.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"currencyCode" : {
|
|
"description" : "The currency in which the bank account deals.\n>The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"iban" : {
|
|
"description" : "The international bank account number.\n>The IBAN standard is defined in ISO-13616.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerCity" : {
|
|
"description" : "The city of residence of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerCountryCode" : {
|
|
"description" : "The country code of the country of residence of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerDateOfBirth" : {
|
|
"description" : "The date of birth of the bank account owner.\n",
|
|
"type" : "string"
|
|
},
|
|
"ownerHouseNumberOrName" : {
|
|
"description" : "The house name or number of the residence of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerName" : {
|
|
"description" : "The name of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerNationality" : {
|
|
"description" : "The country code of the country of nationality of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerPostalCode" : {
|
|
"description" : "The postal code of the residence of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerState" : {
|
|
"description" : "The state of residence of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"ownerStreet" : {
|
|
"description" : "The street name of the residence of the bank account owner.\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"primaryAccount" : {
|
|
"description" : "If set to true, the bank account is a primary account.",
|
|
"type" : "boolean"
|
|
},
|
|
"taxId" : {
|
|
"description" : "The tax ID number.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
},
|
|
"urlForVerification" : {
|
|
"description" : "The URL to be used for bank account verification.\nThis may be generated on bank account creation.\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on field requirements.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"BusinessDetails" : {
|
|
"properties" : {
|
|
"doingBusinessAs" : {
|
|
"description" : "The registered name of the company (if it differs from the legal name of the company).",
|
|
"type" : "string"
|
|
},
|
|
"legalBusinessName" : {
|
|
"description" : "The legal name of the company.",
|
|
"type" : "string"
|
|
},
|
|
"registrationNumber" : {
|
|
"description" : "The registration number of the company.",
|
|
"type" : "string"
|
|
},
|
|
"shareholders" : {
|
|
"description" : "Each of the shareholders associated with the company.\nEach array entry should represent one shareholder.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ShareholderContact"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"taxId" : {
|
|
"description" : "The tax ID of the company.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"CloseAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder to be closed.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"CloseAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountHolderStatus" : {
|
|
"description" : "The new status of the Account Holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderStatus"
|
|
]
|
|
},
|
|
"CloseAccountRequest" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of account to be closed.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountCode"
|
|
]
|
|
},
|
|
"CloseAccountResponse" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The account code of the account that is closed.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
},
|
|
"status" : {
|
|
"description" : "The new status of the account.\n>Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.",
|
|
"enum" : [
|
|
"Active",
|
|
"Closed",
|
|
"Inactive",
|
|
"Suspended"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"status"
|
|
]
|
|
},
|
|
"CreateAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The desired code of the prospective account holder.\n> Must be between three (3) and fifty (50) characters long. Only letters, digits, and hyphens (-) are permitted.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderDetails" : {
|
|
"description" : "The details of the prospective account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderDetails"
|
|
},
|
|
"createDefaultAccount" : {
|
|
"description" : "If set to true, an account with the default options is created for this account holder.\n**Default Value:** true",
|
|
"type" : "boolean"
|
|
},
|
|
"description" : {
|
|
"description" : "A description of the prospective account holder.",
|
|
"type" : "string"
|
|
},
|
|
"legalEntity" : {
|
|
"description" : "The entity type.\nPermitted values: `Business`, `Individual`\n\nIf an account holder is 'Business', then `accountHolderDetails.businessDetails` must be provided, as well as at least one entry in the `accountHolderDetails.businessDetails.shareholders` list.\n\nIf an account holder is 'Individual', then `accountHolderDetails.individualDetails` must be provided.",
|
|
"enum" : [
|
|
"Business",
|
|
"Individual",
|
|
"NonProfit",
|
|
"Partnership",
|
|
"PublicCompany"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"primaryCurrency" : {
|
|
"description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
|
|
"type" : "string"
|
|
},
|
|
"processingTier" : {
|
|
"description" : "The starting [processing tier](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks#tiers) for the prospective account holder.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"legalEntity",
|
|
"accountHolderDetails"
|
|
]
|
|
},
|
|
"CreateAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of a new account created for the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the new account holder.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderDetails" : {
|
|
"description" : "Details of the new account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderDetails"
|
|
},
|
|
"accountHolderStatus" : {
|
|
"description" : "The status of the new account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"description" : {
|
|
"description" : "The description of the new account holder.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "A list of fields that caused the `/createAccountHolder` request to fail.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"legalEntity" : {
|
|
"description" : "The type of legal entity of the new account holder.",
|
|
"enum" : [
|
|
"Business",
|
|
"Individual",
|
|
"NonProfit",
|
|
"Partnership",
|
|
"PublicCompany"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"primaryCurrency" : {
|
|
"description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
|
|
"type" : "string"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
},
|
|
"verification" : {
|
|
"description" : "The details of KYC Verification of the account holder.",
|
|
"$ref" : "#/components/schemas/KYCVerificationResult"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"accountHolderStatus",
|
|
"accountHolderDetails",
|
|
"verification",
|
|
"legalEntity"
|
|
]
|
|
},
|
|
"CreateAccountRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of Account Holder under which to create the account.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "A description of the account.",
|
|
"type" : "string"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"description" : "A set of key and value pairs for general use by the merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
|
|
"type" : "object"
|
|
},
|
|
"payoutSchedule" : {
|
|
"description" : "The payout schedule of the prospective account.\n>Permitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`.",
|
|
"enum" : [
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT",
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_NOON",
|
|
"DAILY",
|
|
"DAILY_6PM",
|
|
"DAILY_AU",
|
|
"DAILY_EU",
|
|
"DAILY_US",
|
|
"DEFAULT",
|
|
"EVERY_6_HOURS_FROM_MIDNIGHT",
|
|
"HOLD",
|
|
"MONTHLY",
|
|
"WEEKLY",
|
|
"WEEKLY_ON_TUE_FRI_MIDNIGHT",
|
|
"YEARLY"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"payoutScheduleReason" : {
|
|
"description" : "The reason for the payout schedule choice.\n>Required if the payoutSchedule is `HOLD`.",
|
|
"type" : "string"
|
|
},
|
|
"payoutSpeed" : {
|
|
"default" : "STANDARD",
|
|
"description" : "Speed with which payouts for this account are processed. Permitted values: `STANDARD`, `SAME_DAY`.",
|
|
"enum" : [
|
|
"SAME_DAY",
|
|
"STANDARD"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"CreateAccountResponse" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of the new account.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "The description of the account.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "A list of fields that caused the `/createAccount` request to fail.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "object"
|
|
},
|
|
"payoutSchedule" : {
|
|
"description" : "The payout schedule of the account.",
|
|
"$ref" : "#/components/schemas/PayoutScheduleResponse"
|
|
},
|
|
"payoutSpeed" : {
|
|
"description" : "Speed with which payouts for this account are processed. Permitted values: `STANDARD`, `SAME_DAY`.",
|
|
"enum" : [
|
|
"SAME_DAY",
|
|
"STANDARD"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
},
|
|
"status" : {
|
|
"description" : "The status of the account.\n>Permitted values: `Active`.",
|
|
"enum" : [
|
|
"Active",
|
|
"Closed",
|
|
"Inactive",
|
|
"Suspended"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"accountCode",
|
|
"status"
|
|
]
|
|
},
|
|
"DeleteBankAccountRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder from which to delete the Bank Account(s).",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountUUIDs" : {
|
|
"description" : "The code(s) of the Bank Accounts to be deleted.",
|
|
"items" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"bankAccountUUIDs"
|
|
]
|
|
},
|
|
"DeletePayoutMethodRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder, from which to delete the payout methods.",
|
|
"type" : "string"
|
|
},
|
|
"payoutMethodCodes" : {
|
|
"description" : "The codes of the payout methods to be deleted.",
|
|
"items" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"payoutMethodCodes"
|
|
]
|
|
},
|
|
"DeleteShareholderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder from which to delete the Shareholders.",
|
|
"type" : "string"
|
|
},
|
|
"shareholderCodes" : {
|
|
"description" : "The code(s) of the Shareholders to be deleted.",
|
|
"items" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"shareholderCodes"
|
|
]
|
|
},
|
|
"DocumentDetail" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of account holder, to which the document applies.",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountUUID" : {
|
|
"description" : "The unique ID of the Bank Account to which the document applies.\n>Required if the documentType is `BANK_STATEMENT` (i.e., a document is being submitted in order to verify a bank account).\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on when a document should be submitted in order to verify a bank account.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "Description of the document.",
|
|
"type" : "string"
|
|
},
|
|
"documentType" : {
|
|
"description" : "The type of a document. Permitted values:\n* `BANK_STATEMENT` denotes an image containing a bank statement or other document proving ownership of a specific bank account.\n* `PASSPORT` denotes an image containing the identity page(s) of a passport.\n* `ID_CARD_FRONT` denotes an image containing only the front of the ID card. In order for a document to be usable, both the `ID_CARD_FRONT` and `ID_CARD_BACK` must be submitted.\n* `ID_CARD_BACK` denotes an image containing only the back of the ID card. In order for a document to be usable, both the `ID_CARD_FRONT` and `ID_CARD_BACK` must be submitted.\n* `DRIVING_LICENCE_FRONT` denotes an image containing only the front of the driving licence. In order for a document to be usable, both the `DRIVING_LICENCE_FRONT` and `DRIVING_LICENCE_BACK` must be submitted.\n* `DRIVING_LICENCE_BACK` denotes an image containing only the back of the driving licence. In order for a document to be usable, both the `DRIVING_LICENCE_FRONT` and `DRIVING_LICENCE_FRONT` must be submitted.\n\n>Please refer to [Verification checks](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks) for details on when each document type should be submitted.",
|
|
"enum" : [
|
|
"BANK_STATEMENT",
|
|
"BSN",
|
|
"COMPANY_REGISTRATION_SCREENING",
|
|
"DRIVING_LICENCE",
|
|
"DRIVING_LICENCE_BACK",
|
|
"DRIVING_LICENCE_FRONT",
|
|
"ID_CARD",
|
|
"ID_CARD_BACK",
|
|
"ID_CARD_FRONT",
|
|
"PASSPORT",
|
|
"SSN",
|
|
"SUPPORTING_DOCUMENTS"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"filename" : {
|
|
"description" : "Filename of the document.",
|
|
"type" : "string"
|
|
},
|
|
"shareholderCode" : {
|
|
"description" : "The code of the shareholder, to which the document applies.\n>Required if the account holder referred to by the `accountHolderCode` has a `legalEntity` of type `Business` and the `documentType` is either `PASSPORT`, `ID_CARD_FRONT`, `ID_CARD_BACK`, `DRIVING_LICENCE_FRONT`, `DRIVING_LICENCE_BACK` (i.e. a document is being submitted in order to verify a shareholder).\n\n>Refer to the [Onboarding and verification](https://docs.adyen.com/platforms/onboarding-and-verification) section for details on when a document should be submitted in order to verify a shareholder.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"documentType",
|
|
"filename"
|
|
]
|
|
},
|
|
"ErrorFieldType" : {
|
|
"properties" : {
|
|
"errorCode" : {
|
|
"description" : "The validation error code.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
},
|
|
"errorDescription" : {
|
|
"description" : "A description of the validation error.",
|
|
"type" : "string"
|
|
},
|
|
"fieldType" : {
|
|
"description" : "The type of error field.",
|
|
"$ref" : "#/components/schemas/FieldType"
|
|
}
|
|
}
|
|
},
|
|
"FieldType" : {
|
|
"properties" : {
|
|
"field" : {
|
|
"description" : "The full name of the property.",
|
|
"type" : "string"
|
|
},
|
|
"fieldName" : {
|
|
"description" : "The type of the field.",
|
|
"enum" : [
|
|
"accountCode",
|
|
"accountHolderCode",
|
|
"accountHolderDetails",
|
|
"accountNumber",
|
|
"accountStateType",
|
|
"accountStatus",
|
|
"accountType",
|
|
"address",
|
|
"bankAccount",
|
|
"bankAccountCode",
|
|
"bankAccountName",
|
|
"bankAccountUUID",
|
|
"bankBicSwift",
|
|
"bankCity",
|
|
"bankCode",
|
|
"bankName",
|
|
"bankStatement",
|
|
"branchCode",
|
|
"businessContact",
|
|
"cardToken",
|
|
"checkCode",
|
|
"city",
|
|
"companyRegistration",
|
|
"country",
|
|
"countryCode",
|
|
"currency",
|
|
"currencyCode",
|
|
"dateOfBirth",
|
|
"description",
|
|
"destinationAccountCode",
|
|
"document",
|
|
"documentExpirationDate",
|
|
"documentIssuerCountry",
|
|
"documentIssuerState",
|
|
"documentName",
|
|
"documentNumber",
|
|
"documentType",
|
|
"doingBusinessAs",
|
|
"drivingLicence",
|
|
"drivingLicenceBack",
|
|
"drivingLicense",
|
|
"email",
|
|
"firstName",
|
|
"fullPhoneNumber",
|
|
"gender",
|
|
"hopWebserviceUser",
|
|
"houseNumberOrName",
|
|
"iban",
|
|
"idCard",
|
|
"idCardBack",
|
|
"idCardFront",
|
|
"idNumber",
|
|
"identityDocument",
|
|
"individualDetails",
|
|
"lastName",
|
|
"legalBusinessName",
|
|
"legalEntity",
|
|
"legalEntityType",
|
|
"merchantAccount",
|
|
"merchantCategoryCode",
|
|
"merchantReference",
|
|
"microDeposit",
|
|
"name",
|
|
"nationality",
|
|
"originalReference",
|
|
"ownerCity",
|
|
"ownerCountryCode",
|
|
"ownerHouseNumberOrName",
|
|
"ownerName",
|
|
"ownerPostalCode",
|
|
"ownerState",
|
|
"ownerStreet",
|
|
"passport",
|
|
"passportNumber",
|
|
"payoutMethodCode",
|
|
"personalData",
|
|
"phoneCountryCode",
|
|
"phoneNumber",
|
|
"postalCode",
|
|
"primaryCurrency",
|
|
"reason",
|
|
"registrationNumber",
|
|
"returnUrl",
|
|
"schedule",
|
|
"shareholder",
|
|
"shareholderCode",
|
|
"socialSecurityNumber",
|
|
"sourceAccountCode",
|
|
"stateOrProvince",
|
|
"status",
|
|
"stockExchange",
|
|
"stockNumber",
|
|
"stockTicker",
|
|
"store",
|
|
"storeDetail",
|
|
"storeName",
|
|
"storeReference",
|
|
"street",
|
|
"taxId",
|
|
"tier",
|
|
"tierNumber",
|
|
"transferCode",
|
|
"unknown",
|
|
"value",
|
|
"virtualAccount",
|
|
"visaNumber",
|
|
"webAddress"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"shareholderCode" : {
|
|
"description" : "The code of the shareholder that the field belongs to. If empty, the field belongs to an account holder.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"GenericResponse" : {
|
|
"properties" : {
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"GetAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of the account of which to retrieve the details.\n> Required if no `accountHolderCode` is provided.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder of which to retrieve the details.\n> Required if no `accountCode` is provided.",
|
|
"type" : "string"
|
|
},
|
|
"showDetails" : {
|
|
"description" : "True if the request should return the account holder details",
|
|
"type" : "boolean"
|
|
}
|
|
}
|
|
},
|
|
"GetAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderDetails" : {
|
|
"description" : "Details of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderDetails"
|
|
},
|
|
"accountHolderStatus" : {
|
|
"description" : "The status of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"accounts" : {
|
|
"description" : "A list of the accounts under the account holder.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/Account"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"description" : {
|
|
"description" : "The description of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"legalEntity" : {
|
|
"description" : "The legal entity of the account holder.",
|
|
"enum" : [
|
|
"Business",
|
|
"Individual",
|
|
"NonProfit",
|
|
"Partnership",
|
|
"PublicCompany"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"primaryCurrency" : {
|
|
"description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
|
|
"type" : "string"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
},
|
|
"systemUpToDateTime" : {
|
|
"description" : "The time that shows how up to date is the information in the response.",
|
|
"format" : "date-time",
|
|
"type" : "string"
|
|
},
|
|
"verification" : {
|
|
"description" : "The details of KYC Verification of the account holder.",
|
|
"$ref" : "#/components/schemas/KYCVerificationResult"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"legalEntity",
|
|
"accountHolderStatus",
|
|
"accountHolderDetails",
|
|
"verification"
|
|
]
|
|
},
|
|
"GetAccountHolderStatusResponse" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderStatus" : {
|
|
"description" : "The status of the Account Holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"accountHolderStatus"
|
|
]
|
|
},
|
|
"GetUploadedDocumentsRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder for which to retrieve the documents.",
|
|
"type" : "string"
|
|
},
|
|
"bankAccountUUID" : {
|
|
"description" : "The code of the Bank Account for which to retrieve the documents.",
|
|
"type" : "string"
|
|
},
|
|
"shareholderCode" : {
|
|
"description" : "The code of the Shareholder for which to retrieve the documents.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"GetUploadedDocumentsResponse" : {
|
|
"properties" : {
|
|
"documentDetails" : {
|
|
"description" : "A list of the documents and their details.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/DocumentDetail"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"IndividualDetails" : {
|
|
"properties" : {
|
|
"name" : {
|
|
"description" : "The name of the individual.\n>Make sure your account holder registers using the name shown on their Photo ID.",
|
|
"$ref" : "#/components/schemas/ViasName"
|
|
},
|
|
"personalData" : {
|
|
"description" : "Personal information of the individual.",
|
|
"$ref" : "#/components/schemas/ViasPersonalData"
|
|
}
|
|
}
|
|
},
|
|
"KYCBankAccountCheckResult" : {
|
|
"properties" : {
|
|
"bankAccountUUID" : {
|
|
"description" : "The unique ID of the bank account to which the check applies.",
|
|
"type" : "string"
|
|
},
|
|
"checks" : {
|
|
"description" : "A list of the checks and their statuses.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCCheckStatusData"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
}
|
|
},
|
|
"KYCCardCheckResult" : {
|
|
"properties" : {
|
|
"checks" : {
|
|
"description" : "A list of the checks and their statuses.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCCheckStatusData"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"payoutMethodCode" : {
|
|
"description" : "The unique ID of the card to which the check applies.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"KYCCheckResult" : {
|
|
"properties" : {
|
|
"checks" : {
|
|
"description" : "A list of the checks and their statuses.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCCheckStatusData"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
}
|
|
},
|
|
"KYCCheckStatusData" : {
|
|
"properties" : {
|
|
"requiredFields" : {
|
|
"description" : "A list of the fields required for execution of the check.",
|
|
"items" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"status" : {
|
|
"description" : "The status of the check.\n>Permitted Values: `DATA_PROVIDED`, `PASSED`, `PENDING`, `AWAITING_DATA`, `RETRY_LIMIT_REACHED`, `INVALID_DATA`, `FAILED`.",
|
|
"enum" : [
|
|
"AWAITING_DATA",
|
|
"DATA_PROVIDED",
|
|
"FAILED",
|
|
"INVALID_DATA",
|
|
"PASSED",
|
|
"PENDING",
|
|
"PENDING_REVIEW",
|
|
"RETRY_LIMIT_REACHED",
|
|
"UNCHECKED"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"summary" : {
|
|
"description" : "A summary of the execution of the check.",
|
|
"$ref" : "#/components/schemas/KYCCheckSummary"
|
|
},
|
|
"type" : {
|
|
"description" : "The type of check.\n>Permitted Values: `COMPANY_VERIFICATION`, `IDENTITY_VERIFICATION`, `PASSPORT_VERIFICATION`, `BANK_ACCOUNT_VERIFICATION`, `NONPROFIT_VERIFICATION`, `CARD_VERIFICATION`.",
|
|
"enum" : [
|
|
"BANK_ACCOUNT_VERIFICATION",
|
|
"CARD_VERIFICATION",
|
|
"COMPANY_VERIFICATION",
|
|
"IDENTITY_VERIFICATION",
|
|
"NONPROFIT_VERIFICATION",
|
|
"PASSPORT_VERIFICATION",
|
|
"PAYOUT_METHOD_VERIFICATION"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"type",
|
|
"status"
|
|
]
|
|
},
|
|
"KYCCheckSummary" : {
|
|
"properties" : {
|
|
"kycCheckCode" : {
|
|
"description" : "The code of the check.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
},
|
|
"kycCheckDescription" : {
|
|
"description" : "A description of the check.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"KYCShareholderCheckResult" : {
|
|
"properties" : {
|
|
"checks" : {
|
|
"description" : "A list of the checks and their statuses.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCCheckStatusData"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"shareholderCode" : {
|
|
"description" : "The code of the shareholder to which the check applies.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"KYCVerificationResult" : {
|
|
"properties" : {
|
|
"accountHolder" : {
|
|
"description" : "The result(s) of the checks on the account holder.",
|
|
"$ref" : "#/components/schemas/KYCCheckResult"
|
|
},
|
|
"bankAccounts" : {
|
|
"description" : "The result(s) of the checks on the bank account(s).",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCBankAccountCheckResult"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"cards" : {
|
|
"description" : "The result(s) of the checks on the card(s).",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCCardCheckResult"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"shareholders" : {
|
|
"description" : "The result(s) of the checks on the shareholder(s).",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/KYCShareholderCheckResult"
|
|
},
|
|
"type" : "array"
|
|
}
|
|
}
|
|
},
|
|
"PayoutMethod" : {
|
|
"properties" : {
|
|
"merchantAccount" : {
|
|
"type" : "string"
|
|
},
|
|
"payoutMethodCode" : {
|
|
"type" : "string"
|
|
},
|
|
"payoutMethodType" : {
|
|
"enum" : [
|
|
"CardToken"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"recurringDetailReference" : {
|
|
"type" : "string"
|
|
},
|
|
"shopperReference" : {
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"merchantAccount",
|
|
"shopperReference",
|
|
"recurringDetailReference"
|
|
]
|
|
},
|
|
"PayoutScheduleResponse" : {
|
|
"properties" : {
|
|
"nextScheduledPayout" : {
|
|
"description" : "The date of the next scheduled payout.",
|
|
"format" : "date-time",
|
|
"type" : "string"
|
|
},
|
|
"schedule" : {
|
|
"description" : "The payout schedule of the account.\n>Permitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`.",
|
|
"enum" : [
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT",
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_NOON",
|
|
"DAILY",
|
|
"DAILY_6PM",
|
|
"DAILY_AU",
|
|
"DAILY_EU",
|
|
"DAILY_US",
|
|
"DEFAULT",
|
|
"EVERY_6_HOURS_FROM_MIDNIGHT",
|
|
"HOLD",
|
|
"MONTHLY",
|
|
"WEEKLY",
|
|
"WEEKLY_ON_TUE_FRI_MIDNIGHT",
|
|
"YEARLY"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"schedule",
|
|
"nextScheduledPayout"
|
|
]
|
|
},
|
|
"PerformVerificationRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder to verify.",
|
|
"type" : "string"
|
|
},
|
|
"accountStateType" : {
|
|
"description" : "The state required for the account holder.\n> Permitted values: `Processing`, `Payout`.",
|
|
"enum" : [
|
|
"LimitedPayout",
|
|
"LimitedProcessing",
|
|
"LimitlessPayout",
|
|
"LimitlessProcessing",
|
|
"Payout",
|
|
"Processing"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"tier" : {
|
|
"description" : "The tier required for the account holder.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"accountStateType",
|
|
"tier"
|
|
]
|
|
},
|
|
"PersonalDocumentData" : {
|
|
"properties" : {
|
|
"expirationDate" : {
|
|
"description" : "The expiration date of the document.\nThe date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).",
|
|
"type" : "string"
|
|
},
|
|
"issuerCountry" : {
|
|
"description" : "The two-character country code of the issuer.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').",
|
|
"maxLength" : 2,
|
|
"minLength" : 2,
|
|
"type" : "string"
|
|
},
|
|
"issuerState" : {
|
|
"description" : "The state issued the document (if applicable)",
|
|
"type" : "string"
|
|
},
|
|
"number" : {
|
|
"description" : "The number of the document. Delete the given type if the value empty.",
|
|
"type" : "string"
|
|
},
|
|
"type" : {
|
|
"description" : "The type of the document. More then one item pert type does not allowed.\nValid values: ID, PASSPORT, VISA, DRIVINGLICENSE",
|
|
"enum" : [
|
|
"DRIVINGLICENSE",
|
|
"ID",
|
|
"PASSPORT",
|
|
"SOCIALSECURITY",
|
|
"VISA"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"type"
|
|
]
|
|
},
|
|
"ShareholderContact" : {
|
|
"properties" : {
|
|
"address" : {
|
|
"description" : "The address of the contact.",
|
|
"$ref" : "#/components/schemas/ViasAddress"
|
|
},
|
|
"email" : {
|
|
"description" : "The e-mail address of the contact.",
|
|
"type" : "string"
|
|
},
|
|
"fullPhoneNumber" : {
|
|
"description" : "The phone number of the contact provided as a single string. It will be handled as a landline phone.\n**Examples:** \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
|
|
"type" : "string"
|
|
},
|
|
"name" : {
|
|
"description" : "The name of the contact.",
|
|
"$ref" : "#/components/schemas/ViasName"
|
|
},
|
|
"personalData" : {
|
|
"description" : "Personal data of the Shareholder.",
|
|
"$ref" : "#/components/schemas/ViasPersonalData"
|
|
},
|
|
"phoneNumber" : {
|
|
"description" : "The phone number of the contact.",
|
|
"$ref" : "#/components/schemas/ViasPhoneNumber"
|
|
},
|
|
"shareholderCode" : {
|
|
"description" : "The unique identifier (UUID) of the Shareholder.\n>**If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.**\n\n>**If, during an Account Holder create request, a UUID is provided, the creation of the Shareholder will fail while the creation of the Account Holder will continue.**\n\n>**If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.**\n\n>**If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.**\n",
|
|
"type" : "string"
|
|
},
|
|
"shareholderReference" : {
|
|
"description" : "Merchant reference to the Shareholder.",
|
|
"type" : "string"
|
|
},
|
|
"webAddress" : {
|
|
"description" : "The URL of the website of the contact.",
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"SuspendAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder to be suspended.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"SuspendAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountHolderStatus" : {
|
|
"description" : "The new status of the Account Holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderStatus"
|
|
]
|
|
},
|
|
"UnSuspendAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder to be reinstated.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"UnSuspendAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountHolderStatus" : {
|
|
"description" : "The new status of the Account Holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "Contains field validation errors that would prevent requests from being processed.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderStatus"
|
|
]
|
|
},
|
|
"UpdateAccountHolderRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder to be updated.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderDetails" : {
|
|
"description" : "The details to which the Account Holder should be updated.\n\nRequired if a processingTier is not provided.",
|
|
"$ref" : "#/components/schemas/AccountHolderDetails"
|
|
},
|
|
"description" : {
|
|
"description" : "The description to which the Account Holder should be updated.",
|
|
"type" : "string"
|
|
},
|
|
"legalEntity" : {
|
|
"description" : "The entity type.\nPermitted values: `Business`, `Individual`\n\nIf an account holder is 'Business', then `accountHolderDetails.businessDetails` must be provided, as well as at least one entry in the `accountHolderDetails.businessDetails.shareholders` list.\n\nIf an account holder is 'Individual', then `accountHolderDetails.individualDetails` must be provided.",
|
|
"enum" : [
|
|
"Business",
|
|
"Individual",
|
|
"NonProfit",
|
|
"Partnership",
|
|
"PublicCompany"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"primaryCurrency" : {
|
|
"description" : "The primary three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), to which the account holder should be updated.",
|
|
"type" : "string"
|
|
},
|
|
"processingTier" : {
|
|
"description" : "The processing tier to which the Account Holder should be updated.\n>The processing tier can not be lowered through this request.\n\n>Required if accountHolderDetails are not provided.",
|
|
"format" : "int32",
|
|
"type" : "integer"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode"
|
|
]
|
|
},
|
|
"UpdateAccountHolderResponse" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"accountHolderDetails" : {
|
|
"description" : "Details of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderDetails"
|
|
},
|
|
"accountHolderStatus" : {
|
|
"description" : "The new status of the account holder.",
|
|
"$ref" : "#/components/schemas/AccountHolderStatus"
|
|
},
|
|
"description" : {
|
|
"description" : "The description of the account holder.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "in case the account holder has not been updated, contains account holder fields, that did not pass the validation.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"legalEntity" : {
|
|
"description" : "The legal entity of the account holder.",
|
|
"enum" : [
|
|
"Business",
|
|
"Individual",
|
|
"NonProfit",
|
|
"Partnership",
|
|
"PublicCompany"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"primaryCurrency" : {
|
|
"description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
|
|
"type" : "string"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
},
|
|
"verification" : {
|
|
"description" : "The details of KYC Verification of the account holder.",
|
|
"$ref" : "#/components/schemas/KYCVerificationResult"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderStatus",
|
|
"verification",
|
|
"legalEntity"
|
|
]
|
|
},
|
|
"UpdateAccountHolderStateRequest" : {
|
|
"properties" : {
|
|
"accountHolderCode" : {
|
|
"description" : "The code of the Account Holder on which to update the state.",
|
|
"type" : "string"
|
|
},
|
|
"disable" : {
|
|
"description" : "If true, disable the requested state. If false, enable the requested state.",
|
|
"type" : "boolean"
|
|
},
|
|
"reason" : {
|
|
"description" : "The reason that the state is being updated.\n>Required if the state is being disabled.",
|
|
"type" : "string"
|
|
},
|
|
"stateType" : {
|
|
"description" : "The state to be updated.\n>Permitted values are: `Processing`, `Payout`",
|
|
"enum" : [
|
|
"LimitedPayout",
|
|
"LimitedProcessing",
|
|
"LimitlessPayout",
|
|
"LimitlessProcessing",
|
|
"Payout",
|
|
"Processing"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountHolderCode",
|
|
"stateType",
|
|
"disable"
|
|
]
|
|
},
|
|
"UpdateAccountRequest" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of the account to update.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "A description of the account.",
|
|
"type" : "string"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"description" : "A set of key and value pairs for general use by the merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
|
|
"type" : "object"
|
|
},
|
|
"payoutSchedule" : {
|
|
"description" : "The details of the payout schedule, to which the account should be updated.",
|
|
"$ref" : "#/components/schemas/UpdatePayoutScheduleRequest"
|
|
},
|
|
"payoutSpeed" : {
|
|
"description" : "Speed with which payouts for this account are processed. Permitted values: `STANDARD`, `SAME_DAY`.",
|
|
"enum" : [
|
|
"SAME_DAY",
|
|
"STANDARD"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountCode"
|
|
]
|
|
},
|
|
"UpdateAccountResponse" : {
|
|
"properties" : {
|
|
"accountCode" : {
|
|
"description" : "The code of the account.",
|
|
"type" : "string"
|
|
},
|
|
"description" : {
|
|
"description" : "The description of the account.",
|
|
"type" : "string"
|
|
},
|
|
"invalidFields" : {
|
|
"description" : "A list of fields that caused the `/updateAccount` request to fail.",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/ErrorFieldType"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"metadata" : {
|
|
"additionalProperties" : {
|
|
"type" : "string"
|
|
},
|
|
"type" : "object"
|
|
},
|
|
"payoutSchedule" : {
|
|
"description" : "The payout schedule of the account.",
|
|
"$ref" : "#/components/schemas/PayoutScheduleResponse"
|
|
},
|
|
"payoutSpeed" : {
|
|
"description" : "Speed with which payouts for this account are processed. Permitted values: `STANDARD`, `SAME_DAY`.",
|
|
"enum" : [
|
|
"SAME_DAY",
|
|
"STANDARD"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"pspReference" : {
|
|
"description" : "The reference of a request. Can be used to uniquely identify the request.",
|
|
"type" : "string"
|
|
},
|
|
"resultCode" : {
|
|
"description" : "The result code.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"accountCode"
|
|
]
|
|
},
|
|
"UpdatePayoutScheduleRequest" : {
|
|
"properties" : {
|
|
"action" : {
|
|
"description" : "Direction on how to handle any payouts that have already been scheduled.\nPermitted values:\n* `CLOSE` will close the existing batch of payouts.\n* `UPDATE` will reschedule the existing batch to the new schedule.\n* `NOTHING` (**default**) will allow the payout to proceed.",
|
|
"enum" : [
|
|
"CLOSE",
|
|
"NOTHING",
|
|
"UPDATE"
|
|
],
|
|
"type" : "string"
|
|
},
|
|
"reason" : {
|
|
"description" : "The reason for the payout schedule update.\n> This field is required when the `schedule` parameter is set to `HOLD`.",
|
|
"type" : "string"
|
|
},
|
|
"schedule" : {
|
|
"description" : "The payout schedule to which the account is to be updated.\nPermitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`.\n`HOLD` will prevent scheduled payouts from happening but will still allow manual payouts to occur.",
|
|
"enum" : [
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT",
|
|
"BIWEEKLY_ON_1ST_AND_15TH_AT_NOON",
|
|
"DAILY",
|
|
"DAILY_6PM",
|
|
"DAILY_AU",
|
|
"DAILY_EU",
|
|
"DAILY_US",
|
|
"DEFAULT",
|
|
"EVERY_6_HOURS_FROM_MIDNIGHT",
|
|
"HOLD",
|
|
"MONTHLY",
|
|
"WEEKLY",
|
|
"WEEKLY_ON_TUE_FRI_MIDNIGHT",
|
|
"YEARLY"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"schedule"
|
|
]
|
|
},
|
|
"UploadDocumentRequest" : {
|
|
"properties" : {
|
|
"documentContent" : {
|
|
"description" : "The content of the document as represented by a Base64-encoded string.\n\nTo learn about requirements, see [Bank account check](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks/bank-account-check#requirements) and [Photo ID check](https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks/photo-id-check#requirements).",
|
|
"format" : "byte",
|
|
"type" : "string"
|
|
},
|
|
"documentDetail" : {
|
|
"description" : "Details of the document being submitted.",
|
|
"$ref" : "#/components/schemas/DocumentDetail"
|
|
}
|
|
},
|
|
"required" : [
|
|
"documentDetail",
|
|
"documentContent"
|
|
]
|
|
},
|
|
"ViasAddress" : {
|
|
"properties" : {
|
|
"city" : {
|
|
"description" : "The name of the city.\n>Required if either `houseNumberOrName`, `street`, `postalCode`, or `stateOrProvince` are provided.",
|
|
"type" : "string"
|
|
},
|
|
"country" : {
|
|
"description" : "The two-character country code of the address. The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n> If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`.",
|
|
"type" : "string"
|
|
},
|
|
"houseNumberOrName" : {
|
|
"description" : "The number or name of the house.",
|
|
"type" : "string"
|
|
},
|
|
"postalCode" : {
|
|
"description" : "The postal code.\n>A maximum of five (5) digits for an address in the USA, or a maximum of ten (10) characters for an address in all other countries.\n>Required if either `houseNumberOrName`, `street`, `city`, or `stateOrProvince` are provided.",
|
|
"type" : "string"
|
|
},
|
|
"stateOrProvince" : {
|
|
"description" : "The abbreviation of the state or province.\n>Two (2) characters for an address in the USA or Canada, or a maximum of three (3) characters for an address in all other countries.\n>Required for an address in the USA or Canada if either `houseNumberOrName`, `street`, `city`, or `postalCode` are provided.",
|
|
"type" : "string"
|
|
},
|
|
"street" : {
|
|
"description" : "The name of the street.\n>The house number should not be included in this field; it should be separately provided via `houseNumberOrName`.\n>Required if either `houseNumberOrName`, `city`, `postalCode`, or `stateOrProvince` are provided.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"country"
|
|
]
|
|
},
|
|
"ViasName" : {
|
|
"properties" : {
|
|
"firstName" : {
|
|
"description" : "The first name.",
|
|
"type" : "string"
|
|
},
|
|
"gender" : {
|
|
"description" : "The gender.\n>The following values are permitted: `MALE`, `FEMALE`, `UNKNOWN`.",
|
|
"enum" : [
|
|
"MALE",
|
|
"FEMALE",
|
|
"UNKNOWN"
|
|
],
|
|
"maxLength" : 1,
|
|
"minLength" : 1,
|
|
"type" : "string"
|
|
},
|
|
"infix" : {
|
|
"description" : "The name's infix, if applicable.\n>A maximum length of twenty (20) characters is imposed.",
|
|
"type" : "string"
|
|
},
|
|
"lastName" : {
|
|
"description" : "The last name.",
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"firstName",
|
|
"lastName",
|
|
"gender"
|
|
]
|
|
},
|
|
"ViasPersonalData" : {
|
|
"properties" : {
|
|
"dateOfBirth" : {
|
|
"description" : "The date of birth of the person.\nThe date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).",
|
|
"type" : "string"
|
|
},
|
|
"documentData" : {
|
|
"description" : "Key value pairs of document type and identify numbers",
|
|
"items" : {
|
|
"$ref" : "#/components/schemas/PersonalDocumentData"
|
|
},
|
|
"type" : "array"
|
|
},
|
|
"nationality" : {
|
|
"description" : "The nationality of the person represented by a two-character country code.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').",
|
|
"maxLength" : 2,
|
|
"minLength" : 2,
|
|
"type" : "string"
|
|
}
|
|
}
|
|
},
|
|
"ViasPhoneNumber" : {
|
|
"properties" : {
|
|
"phoneCountryCode" : {
|
|
"description" : "The two-character country code of the phone number.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').",
|
|
"type" : "string"
|
|
},
|
|
"phoneNumber" : {
|
|
"description" : "The phone number.\n>The inclusion of the phone number country code is not necessary.",
|
|
"type" : "string"
|
|
},
|
|
"phoneType" : {
|
|
"description" : "The type of the phone number.\n>The following values are permitted: `Landline`, `Mobile`, `SIP`, `Fax`.",
|
|
"enum" : [
|
|
"Fax",
|
|
"Landline",
|
|
"Mobile",
|
|
"SIP"
|
|
],
|
|
"type" : "string"
|
|
}
|
|
},
|
|
"required" : [
|
|
"phoneCountryCode",
|
|
"phoneNumber"
|
|
]
|
|
}
|
|
},
|
|
"securitySchemes" : {
|
|
"ApiKeyAuth" : {
|
|
"in" : "header",
|
|
"name" : "X-API-Key",
|
|
"type" : "apiKey"
|
|
},
|
|
"BasicAuth" : {
|
|
"scheme" : "basic",
|
|
"type" : "http"
|
|
}
|
|
}
|
|
}
|
|
} |