Are you looking for test card numbers?

Would you like to contact support?

Atenção, esta página não se encontra disponível em Português
Developer-resource icon

Building Adyen solutions

Identify yourself when building a solution for multiple merchants, so that we can offer better support.

Point of sale

Learn how to provide application information when building a point-of-sale integration.

If you're building a solution that allows multiple businesses to process payments with Adyen, make sure that you:

  • Use one of our libraries.
  • Provide application info, so that we can inform you of relevant updates to our API, and offer other support.

Application info includes:

  • Merchant application: The application that you use for interacting with Adyen. For example, a plugin or a cash register software.

    • applicationInfo.merchantApplication.name: The name of the application, for example adyen-salesforcecommerce.

    • applicationInfo.merchantApplication.version: The software version of the application, for example 21.1.0.

  • External platform: Third-party platform (if any) that you use for initiating payment requests.

    • applicationInfo.externalPlatform.integrator: The name of the company that built the integration with the platform, for example system_integrator.
    • applicationInfo.externalPlatform.name: The name of the platform, for example salesforcecommerce.

    • applicationInfo.externalPlatform.version: The software version of the platform, for example 1.7.

The following example shows how to provide application info in the /payments request:

curl https://checkout-test.adyen.com/v68/payments \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "applicationInfo":{
     "merchantApplication":{
        "name":"YOUR_PLUGIN",
        "version":"YOUR_PLUGIN_VERSION"
     },
     "externalPlatform":{
        "name":"PLATFORM_NAME",
        "version":"PLATFORM_VERSION",
        "integrator":"YOUR_SYSTEM_INTEGRATOR_NAME"
     }
  }
  ...
}'
# Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen::Client.new
adyen.api_key = "YOUR_X-API-KEY"

request = {
  :applicationInfo => {
    :merchantApplication => {
      :name => "YOUR_PLUGIN",
      :version => "YOUR_PLUGIN_VERSION"
    },
    :externalPlatform => {
      :name => "PLATFORM_NAME",
      :version => "PLATFORM_VERSION",
      :integrator => "YOUR_SYSTEM_INTEGRATOR_NAME"
    }
  },
  # Add PaymentRequest information here.
}

response = adyen.checkout.payment_methods(request)
// Set your X-API-KEY with the API key from the Customer Area.
Client client = new Client("YOUR_X-API-KEY", Environment.TEST, "null");
Checkout checkout = new Checkout(client);

ApplicationInfo applicationInfo = new ApplicationInfo();

CommonField merchantApplication = new CommonField();
merchantApplication.setName("YOUR_PLUGIN");
merchantApplication.setVersion("YOUR_PLUGIN_VERSION");
applicationInfo.setMerchantApplication(merchantApplication);

ExternalPlatform externalPlatform = new ExternalPlatform();
externalPlatform.setName("PLATFORM_NAME");
externalPlatform.setVersion("PLATFORM_VERSION");
externalPlatform.setIntegrator("YOUR_SYSTEM_INTEGRATOR_NAME");
applicationInfo.setExternalPlatform(externalPlatform);

PaymentsRequest paymentsRequest = new PaymentsRequest();
paymentsRequest.setApplicationInfo(applicationInfo);

// Add PaymentRequest information here.

PaymentsResponse paymentsResponse = checkout.payments(paymentsRequest);
// Set your X-API-KEY with the API key from the Customer Area.
$client = new \Adyen\Client();
$client->setXApiKey("YOUR_X-API-KEY");
$service = new \Adyen\Service\Checkout($client);

$params = array(
    "applicationInfo" => array(
        "merchantApplication" => array(
            "name" => "YOUR_PLUGIN",
            "version" => "YOUR_PLUGIN_VERSION"
        ),
        "externalPlatform" => array(
            "name" => "PLATFORM_NAME",
            "version" => "PLATFORM_VERSION",
            "integrator" => "YOUR_SYSTEM_INTEGRATOR_NAME"
        )
    )
    // Add PaymentRequest information here.
);

$result = $service->payments($params);
# Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen.Adyen()
adyen.client.xapikey = 'YOUR_X-API-KEY'

request = {
  'applicationInfo': {
    'merchantApplication': {
      'name': 'YOUR_PLUGIN',
      'version': 'YOUR_PLUGIN_VERSION'
    },
    'externalPlatform': {
      'name': 'PLATFORM_NAME',
      'version': 'PLATFORM_VERSION',
      'integrator': 'YOUR_SYSTEM_INTEGRATOR_NAME'
    }
  },
  # Add PaymentRequest information here.
}

response = adyen.checkout.payment_methods(request)
// Set your X-API-KEY with the API key from the Customer Area.
var client = new Client("YOUR-X-API-KEY", environment:Model.Enum.Environment.Test);
var checkout = new Checkout(client);
var paymentRequest = new PaymentRequest();

var merchantApplication = new Model.ApplicationInformation.CommonField("YOUR_PLUGIN", "YOUR_PLUGIN_VERSION");
var externalPlatform = new Model.ApplicationInformation.ExternalPlatform("PLATFORM_NAME", "PLATFORM_VERSION", "YOUR_SYSTEM_INTEGRATOR_NAME");

paymentRequest.ApplicationInfo.MerchantApplication = merchantApplication;
paymentRequest.ApplicationInfo.ExternalPlatform = externalPlatform;

var paymentResponse = checkout.Payments(paymentRequest);

See also