{"title":"Upgrade to Checkout API v72","category":"default","creationDate":1778167250,"content":"

Checkout API v72 introduces validations to the values that you send in API requests. To upgrade to this version, you must make sure that the data you send meets our validations.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nAn online payments integration that uses Checkout API<\/a>.<\/td>\n<\/tr>\n
API credential roles<\/a><\/strong><\/td>\nMake sure that you have the following role:
  • Checkout webservice role<\/strong><\/li><\/ul><\/td>\n<\/tr>\n
Customer Area roles<\/a><\/strong><\/td>\nMake sure that you have one of the following roles:
  • Merchant admin role<\/strong><\/li>
  • Manage API credentials<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Validate the data that you send<\/h2>\n

    Check that the values that you send in each parameter in the following table meets the validations.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Parameter<\/th>\nValidation requirement<\/th>\n<\/tr>\n<\/thead>\n
    billingAddress.postalCode<\/code><\/td>\nMaximum length: 10 characters.<\/td>\n<\/tr>\n
    billingAddress.stateOrProvinceCode<\/code><\/td>\nMaximum length: 10 characters.<\/td>\n<\/tr>\n
    captureDelayHours<\/code><\/td>\nMaximum value: 672<\/strong>. This maximum value corresponds to 28 (twenty-eight) days.<\/td>\n<\/tr>\n
    dateOfBirth<\/code><\/td>\nFormat requirement:Must be in ISO-8601<\/a> format with the date (YYYY-MM-DD<\/code>). Example: 2005-03-01<\/strong> (March 1, 2025).<\/td>\n<\/tr>\n
    deliveryAddress.postalCode<\/code><\/td>\nMaximum length: 10 characters.<\/td>\n<\/tr>\n
    deliveryAddress.stateOrProvinceCode<\/code><\/td>\nFormat requirement:
    entityType<\/code><\/td>\nPossible values:
    • NaturalPerson<\/strong><\/li>
    • CompanyName<\/strong><\/li><\/ul><\/td>\n<\/tr>\n
    metadata<\/code><\/td>\nMaximum lengths:
    • For the key: 20 characters.<\/li>
    • For the value: 80 characters.<\/li><\/ul><\/td>\n<\/tr>\n
    reference<\/code><\/td>\nMaximum length: 80 characters.<\/td>\n<\/tr>\n
    returnUrl<\/code><\/td>\nFormat requirement:
    shopperEmail<\/code><\/td>\nFormat requirements:
    • Must not have spaces.<\/li>
    • Must contain the at symbol character(@<\/code>) .<\/li>
    • Must contain text before and after the at symbol character (@<\/code>).<\/li>
    • The email domain must not start with the period character (.<\/code>).<\/li>
    • The username must not include the quotation marks character (\"<\/code>), unless the whole name is in quotation marks.<\/li><\/ul>
      Maximum length:
      • 256 characters.<\/li><\/ul><\/td>\n<\/tr>\n
    shopperIP<\/code><\/td>\nMaximum length: 256 characters.<\/td>\n<\/tr>\n
    shopperName.firstName<\/code><\/td>\nMaximum length: 100 characters.<\/td>\n<\/tr>\n
    shopperName.lastName<\/code><\/td>\nMaximum length: 100 characters.<\/td>\n<\/tr>\n
    socialSecurityNumber<\/code><\/td>\nMaximum length: 50 characters.<\/td>\n<\/tr>\n
    telephoneNumber<\/code><\/td>\nMaximum length: 64 characters.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","url":"https:\/\/docs.adyen.com\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v72","articleFields":{"description":"Find what you must do to upgrade to Checkout API v72.","robots":"noindex,nofollow","feedback_component":true},"algolia":{"url":"https:\/\/docs.adyen.com\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v72","title":"Upgrade to Checkout API v72","content":"Checkout API v72 introduces validations to the values that you send in API requests. To upgrade to this version, you must make sure that the data you send meets our validations.\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAn online payments integration that uses Checkout API.\n\n\nAPI credential roles\nMake sure that you have the following role: Checkout webservice role\n\n\nCustomer Area roles\nMake sure that you have one of the following roles: Merchant admin role Manage API credentials\n\n\n\nValidate the data that you send\nCheck that the values that you send in each parameter in the following table meets the validations.\n\n\n\nParameter\nValidation requirement\n\n\n\n\nbillingAddress.postalCode\nMaximum length: 10 characters.\n\n\nbillingAddress.stateOrProvinceCode\nMaximum length: 10 characters.\n\n\ncaptureDelayHours\nMaximum value: 672. This maximum value corresponds to 28 (twenty-eight) days.\n\n\ndateOfBirth\nFormat requirement:Must be in ISO-8601 format with the date (YYYY-MM-DD). Example: 2005-03-01 (March 1, 2025).\n\n\ndeliveryAddress.postalCode\nMaximum length: 10 characters.\n\n\ndeliveryAddress.stateOrProvinceCode\nFormat requirement: Must be an ISO 3166-1 alpha-2 code.Maximum length:2 characters.\n\n\nentityType\nPossible values: NaturalPersonCompanyName\n\n\nmetadata\nMaximum lengths:For the key: 20 characters.For the value: 80 characters.\n\n\nreference\nMaximum length: 80 characters.\n\n\nreturnUrl\nFormat requirement: Must meet the RFC 2396 standard. If the URL to return to includes non-ASCII characters, like spaces or special letters, you must URL encode the value.Maximum length:1024 characters.\n\n\nshopperEmail\nFormat requirements: Must not have spaces.Must contain the at symbol character(@) .Must contain text before and after the at symbol character (@).The email domain must not start with the period character (.).The username must not include the quotation marks character (\"), unless the whole name is in quotation marks.Maximum length:256 characters.\n\n\nshopperIP\nMaximum length: 256 characters.\n\n\nshopperName.firstName\nMaximum length: 100 characters.\n\n\nshopperName.lastName\nMaximum length: 100 characters.\n\n\nsocialSecurityNumber\nMaximum length: 50 characters.\n\n\ntelephoneNumber\nMaximum length: 64 characters.\n\n\n\n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Upgrade your integration","lvl3":"Upgrade to Checkout API v72"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/online-payments","lvl2":"https:\/\/docs.adyen.com\/online-payments\/upgrade-your-integration","lvl3":"\/online-payments\/upgrade-your-integration\/upgrade-to-checkout-api-v72"},"levels":4,"category":"Online Payments","category_color":"green","tags":["Upgrade","Checkout"]}}