Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Test scenarios

Test your MarketPay integration.

Adyen MarketPay 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).

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), and for each shareholder set name.lastName to TestData.

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.

    {
       "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:

    {
        "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"
            }
        },
        "createDefaultAccount": "true"
    }

    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:

    {
      "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