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 as follows:

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

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.

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

  • Upload a document 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