Partnership type<\/h2>\n
The application fields that you send depends on your partnership type.<\/p>\n
- \n
- Technology partner (also known as solution or product provider): you own the global product brand for solutions like point-of-sale (POS), enterprise resource planning (ERP), kiosk, mobile, or ecommerce. Your products are used by other partners and merchants.<\/li>\n
- Service partner or system integrator (SI): you are a service partner or system integrator if you integrate or implement third-party product solutions for merchants. This includes strategic consulting, custom integration, implementation, or field services.<\/li>\n<\/ul>\n
Send application information<\/h2>\n
To send application information, include the
applicationInfo<\/code> object in your API requests to Adyen. For example, the \/payments<\/a> request, the \/sessions<\/a> request, or requests from your in-person payments IPP integration<\/a>.<\/p>\nYou can use the following example to help you identify which application info fields to send in. This example includes the descriptions of the partner types and cases that show what application information to send.<\/p>\n
\nYou are required to send application information. If you do not, we are limited on how we can help you troubleshoot issues with your integration.<\/p>\n<\/div>\n
Technology partner<\/h3>\n
In this example, the technology partner is a company called Vend Vantage Solutions<\/strong> that provides a suite of products called adVantage Commerce Suite<\/strong> that includes products called adVantage POS<\/strong> (point-of-sale software) and adVantage Digital<\/strong> (ecommerce software).<\/p>\n
CmdyYXBoIFRECiAgICBBWyJUZWNobm9sb2d5IHBhcnRuZXI8YnIvPihmb3IgZXhhbXBsZSwgVmVuZCBWYW50YWdlIFNvbHV0aW9ucykiXSAtLSBZb3UgYnVpbGQgLS0+IEJbIllvdXIgcHJvZHVjdC9wbGF0Zm9ybTxici8+KGZvciBleGFtcGxlLCBhZFZhbnRhZ2UgQ29tbWVyY2UgU3VpdGUgPGJyLz53aXRoIHRoZSBwcm9kdWN0cyBhZFZhbnRhZ2UgUE9TIGFuZCBhZFZhbnRhZ2UgRGlnaXRhbCkiXTsKICAgIENbIk1lcmNoYW50Il0gLS0gVXNlcyB5b3VyIHByb2R1Y3RzIC0tPiBCOwogICAgQiAtLSAiU2VuZHMgQVBJIHJlcXVlc3RzPGJyLz4oaW5jbHVkZXMgJ2FwcGxpY2F0aW9uSW5mbycpIiAtLT4gRFsoIkFkeWVuIildOwogICAgc3R5bGUgRCBmaWxsOiMwYWJmNTMsc3Ryb2tlOiMwNzhmM2UsY29sb3I6I2ZmZgo=<\/div><\/div>\nIf you are a technology partner, include the following fields.<\/p>\n
\n\n
\n \nField<\/th>\n Required<\/th>\n Description<\/th>\n Example<\/th>\n<\/tr>\n<\/thead>\n \n applicationInfo.externalPlatform.name<\/code><\/td>\n![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\nThe name of your product platform. If the product does not have a platform name, use your company name.<\/td>\n adVantage_Commerce_Suite<\/strong><\/td>\n<\/tr>\n \n applicationInfo.merchantApplication.name<\/code><\/td>\n<\/td>\n The name of the specific product that uses Adyen services.<\/td>\n adVantage_POS<\/strong> or adVantage_Digital<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The following example shows a payment request with the
applicationInfo<\/code> fields.<\/p>\n\n<\/code-sample>\n<\/div>\n Service partner or system integrator (SI)<\/h3>\n
In this example, there are two service partners or system integrators:<\/p>\n
- \n
- Vend Consulting<\/strong><\/li>\n
- Vend Global Services<\/strong><\/li>\n<\/ul>\n
CmdyYXBoIFRECiAgICBBWyJNZXJjaGFudCJdIC0tIEhpcmVzIHlvdSAtLT4gQlsiU2VydmljZSBwYXJ0bmVyL2ludGVncmF0b3I8YnIvPihmb3IgZXhhbXBsZSwgVmVuZCBDb25zdWx0aW5nIG9yIFZlbmQgR2xvYmFsIFNlcnZpY2VzKSJdOwogICAgQSAtLSBVc2VzIC0tPiBDWyJUaGlyZC1wYXJ0eSBwcm9kdWN0PGJyLz4oZm9yIGV4YW1wbGUsIGFuIGVjb21tZXJjZSBwbHVnaW4pIl07CiAgICBCIC0tICJZb3UgaW50ZWdyYXRlIHdpdGggb3IgcHJvdmlkZSBzZXJ2aWNlcyBvbiIgLS0+IEM7CiAgICBDIC0tICJTZW5kcyBBUEkgcmVxdWVzdHM8YnIvPihpbmNsdWRlcyAnYXBwbGljYXRpb25JbmZvJykiIC0tPiBEWygiQWR5ZW4iKV07CiAgICBzdHlsZSBEIGZpbGw6IzBhYmY1MyxzdHJva2U6IzA3OGYzZSxjb2xvcjojZmZmCg==<\/div><\/div>\nIf you are a service provider or system integrator, include the following fields.<\/p>\n
\n\n
\n \nField<\/th>\n Required<\/th>\n Description<\/th>\n Example<\/th>\n<\/tr>\n<\/thead>\n \n applicationInfo.externalPlatform.integrator<\/code><\/td>\n<\/td>\nThe name of your company or department providing the integration or consulting services.<\/td>\n Vend_Consulting<\/strong> or Vend_Global_Services<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The following example shows a payment request with the
applicationInfo<\/code> fields.<\/p>\n\n<\/code-sample>\n<\/div>\n Field value requirements<\/h3>\n
The values you send in the application info fields can:<\/p>\n
- \n
- Be between up to 40 characters in length.<\/li>\n
- Start with a number or letter.<\/li>\n
- Contain letters, digits, dashes, underscores, and spaces.<\/li>\n<\/ul>\n\n
The formatting of the values must be the same in every request.
For example, if theexternalPlatform.name<\/code> value is adVantage_Commerce_Suite<\/strong>, you cannot sometimes use a different value like adVantage_CommerceSuite<\/strong> or ADVANTAGECOMMERCESUITE<\/strong>. You must choose one format and use it for every request.<\/p>\n<\/div><\/div>\nOptional application information fields<\/h2>\n
In addition to the required fields for your partnership type, we recommend that you also include additional fields.<\/p>\n
\n\n
\n \nField<\/th>\n Required<\/th>\n Description<\/th>\n Example<\/th>\n<\/tr>\n<\/thead>\n \n externalPlatform.version<\/td>\n <\/td>\n The version of the platform.<\/td>\n 1.0.0<\/td>\n<\/tr>\n \n merchantApplication.name<\/td>\n <\/td>\n The name of the application that the merchant uses.<\/td>\n adVantage_Digital<\/strong><\/td>\n<\/tr>\n \n merchantApplication.version<\/td>\n <\/td>\n The version of the application that the merchant uses.<\/td>\n 2.1.0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n See also<\/h2>\n
- Vend Global Services<\/strong><\/li>\n<\/ul>\n
- Vend Consulting<\/strong><\/li>\n