Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Test scenarios

Test your integration.

Adyen for Platforms provides you with a set of predefined test scenarios to test your integration. Make an API call to either /createAccountHolder or /updateAccountHolder endpoints and assign the values as described to trigger a test:

  • For an individual account holder, set name.lastName and bankAccount.ownerName to TestData.
  • For a business account holder, set businessDetails.legalBusinessName and bankAccount.ownerName to TestData.

Additional values for each test scenario are listed below.

An account holder in a payout state

For individual account holders:

  • Set address.city to PASSED.
  • Set bankAccount.ownerCity to PASSED for all banks accounts (at least one bank account must be defined).
  • Set name.lastName to TestData

For business account holders:

  • Set address.city to PASSED.
  • Set bankAccount.ownerCity to PASSED for all banks accounts (at least one bank account must be defined).
  • Set name.lastName to TestData for each shareholder.

If you want to set an account holder to a limitless account state, also provide a photo ID:

  • Upload a document with the /uploadDocument call with documentType = PASSPORT and description =  PASSED.

Example flow for payout state

An account can be created in Payout state by performing the following steps:

  1. Perform a POST /createAccountHolder request.

    Create account holder request
    {
       "accountHolderCode":"YOUR_UNIQUE_ACCOUNTHOLDER_CODE",
       "accountHolderDetails":{
          "address":{
             "country":"NL"
          },
          "businessDetails":{
             "legalBusinessName":"John Doe's business"
          },
          "email":"john@doe.com"
       },
       "legalEntity":"Business",
       "processingTier":2
    }
    
  2. Perform a POST /updateAccountHolder request. Set the required test data fields to PASSED and to TestData:

    Update account holder request
    {
        "accountHolderCode": "YOUR_UNIQUE_ACCOUNTHOLDER_CODE",
        "accountHolderDetails": {
            "address": {
                "city": "PASSED",
                "country": "NL",
                "postalCode": "12345",
                "street": "az",
                "stateOrProvince": "CA",
                "houseNumberOrName": 1
            },
            "bankAccountDetails": [
                {
                    "iban": "DE89888888881234567890",
                    "countryCode": "DE",
                    "currencyCode": "EUR",
                    "ownerName": "TestData",
                    "ownerHouseNumberOrName": "100",
                    "ownerStreet": "Main Street",
                    "ownerPostalCode": "02894",
                    "ownerCity": "PASSED",
                    "ownerState": "AZ",
                    "ownerCountryCode": "NL"
                }
            ],
            "businessDetails": {
                "legalBusinessName": "TestData",
                "taxId": "23456222",
                "shareholders": [
                    {
                        "address": {
                            "city": "PASSED",
                            "country": "US",
                            "postalCode": "12344",
                            "street": "az",
                            "stateOrProvince": "CA",
                            "houseNumberOrName": 1
                        },
                        "email": "manager@test2.de",
                        "name": {
                            "firstName": "NameFirst",
                            "gender": "UNKNOWN",
                            "lastName": "TestData"
                        },
                        "personalData": {
                            "dateOfBirth": "2014-06-09",
                            "documentData": [
                                {
                                    "number": "1234567",
                                    "type": "ID"
                                }
                            ]
                        }
                    }
                ]
            },
            "email": "company@test2.de",
            "phoneNumber": {
                "phoneCountryCode": "NL",
                "phoneNumber": "1234567890",
                "phoneType": "Landline"
            }
        }
    }

    The /updateAccountHolder response contains a shareholderCode. You need this to submit a request to upload the Passport document. You can also get the shareholderCode through a /getAccountHolder request.

  3. Make a POST /uploadDocument request:

    Upload document request
    {
      "documentDetail": {
        "shareholderCode": "YOUR_SHAREHOLDER_CODE",
        "documentType": "PASSPORT",
        "accountHolderCode": "YOUR_UNIQUE_ACCOUNTHOLDER_CODE",
        "filename": "doc.pdf",
        "description": "PASSED"
      },
      "documentContent": "JVBERi0xLjQKJ...."
    }

    The account holder will now have its company, identity, and document verified.

An account holder with one of KYC checks set to FAILED

  • Set address.city to FRAUD.

  • Set bankAccount.ownerCity to FRAUD for all banks accounts, which should be marked as Failed.
  • Set description to FRAUD for a passport, if you need its KYC check to be marked as Failed.

Here is an example of creating a suspended Individual legal entity account holder with its payouts blocked using the /createAccountHolder API.

{
  "accountHolderCode": "YOUR_UNIQUE_ACCOUNT_HOLDER_CODE",
  "accountHolderDetails": {
    "address": {
        "country": "US",
        "city": "FRAUD",
        "street": "Test street",
        "stateOrProvince": "NY",
        "postalCode": "10011"
    },
    "businessDetails": {
      "legalBusinessName": "TestData",
      "bankAccountDetails": {
        "ownerName": "TestData",
        "ownerCity": "FRAUD"
      },
      "shareholders": [
        {
            "name": {
              "firstName": "John",
              "gender": "FEMALE",
              "lastName": "Doe"
            },
            "address": {
              "country": "US"
            }
        }
      ]
    },
    "email": "john@doe.com"
  },
  "processingTier": 2,
  "legalEntity": "Business"
}

An account holder with one of KYC checks set to INVALID_DATA

  • Set address.city to INVALIDDATA.
  • Set bankAccount.ownerCity to INVALIDDATA for all banks accounts, which should be marked as Failed.
  • Set description to INVALIDDATA for a passport, if you need its KYC check to be marked as Failed.

An account holder with a PASSPORT_VERIFICATION KYC check set to INVALID_DATA

  • /uploadDocument with documentType = PASSPORT and description = INVALIDDATA.

Inactivate an account holder and schedule a refund

  • Set address.city to INACTIVEDEADLINECITY.

The /refundNotPaidOutTransfers call is scheduled to be performed in 6 weeks.

Inactivate an account holder and make a refund

  • Set address.city to REFUNDDEADLINECITY.

In this case the /refundNotPaidOutTransfers call is performed immediately.

See also