{"title":"Partial payments using Hosted Payment Pages","category":"default","creationDate":1776961627,"content":"
\n

Hosted Payment Pages are no longer available<\/strong><\/p>\n

To accept payments through an Adyen-hosted page, use our Hosted Checkout<\/a>.<\/p>\n

This page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life. We are no longer processing transactions though HPP.<\/p>\n<\/div><\/div>\n

A flexible, secure and easy way to allow your customers to pay for your goods or services. When a shopper needs to pay to complete an order they are transferred from your site to the HPP where the customer performs the payment. The shopper is then directed back to your site along with the result of the payment.\u00a0<\/p>\n

In some\u00a0cases,\u00a0you may want for a shopper to pay the full payment amount via multiple payment methods. This is called partial payments: a single payment request that is paid via multiple payment methods.\u00a0<\/p>\n

The first until the second-last partial payment can be one of the following payment methods:\u00a0<\/p>\n\n\n\n\n\n\n\n\n
<\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
Payment Method<\/strong><\/td>\nValue<\/strong><\/td>\n<\/tr>\n
Webshop Giftcard<\/td>\nwebshopgiftcard<\/td>\n<\/tr>\n
VVV Giftcard<\/td>\nvvvgiftcard<\/td>\n<\/tr>\n
Other giftcards<\/td>\n-<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The last partial payment must always be a payment method which has a direct\/online result. Below a list of all supported payment methods:\u00a0<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
<\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
Payment Method<\/strong><\/td>\nValue<\/strong><\/td>\n<\/tr>\n
Visa<\/td>\nvisa<\/td>\n<\/tr>\n
Mastercard<\/td>\nmc<\/td>\n<\/tr>\n
Amex<\/td>\namex<\/td>\n<\/tr>\n
iDEAL<\/td>\nideal<\/td>\n<\/tr>\n
Webshop Giftcard<\/td>\nwebshopgiftcard<\/td>\n<\/tr>\n
VVV Giftcard<\/td>\nvvvgiftcard<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Payment methods like bank transfers are not supported as these do not have an online result.<\/p>\n

Skin settings<\/h2>\n

To enable partial payments, in the\u00a0Skin Options<\/strong>\u00a0drop-down, activate the\u00a0Support partial payments<\/strong>\u00a0option on the skin you use with Adyen via\u00a0Customer Area<\/a>.\u00a0<\/p>\n

Finish by clicking the\u00a0Save Skin to Test<\/strong>\u00a0button.<\/p>\n

Payment Selection<\/h3>\n

Before processing the first partial payment an order is created. Like a normal payment, this order has a unique\u00a0pspReference<\/code>.\u00a0All partial payments are available in the\u00a0Payment List<\/strong>\u00a0as normal payments. The merchant reference for the partial payments of one order are the same.<\/p>\n

After a partial payment the shopper is redirected back to the HPP to pay for the pending amount. The second payment can also be a partial payment of the amount that is pending.\u00a0The sum of the payment amounts of the partial payments for one order should be the same as the total amount of the order (if all payments were successful).<\/p>\n

There isn't any maximum number of partial payments for a single payment request.<\/p>\n

You can add a custom\u00a0Column Configuration<\/strong>\u00a0in the Payment list. In this custom configuration, you can add the\u00a0Order Reference<\/strong>\u00a0column. This column contains the\u00a0pspReference<\/code>\u00a0as submitted back in the\u00a0ORDER_OPEN<\/code>\u00a0and the\u00a0ORDER_CLOSED<\/code>\u00a0webhook events.<\/p>\n

Webhooks<\/h2>\n

Open an order<\/h3>\n

If the first payment for your payment request is a partial payment, an order is created. This generates an\u00a0ORDER_OPENED<\/code>\u00a0webhook event<\/a>. The following fields are sent in this event:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Field<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
live<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nBoolean indicating if the event originated from the Live payment system (TRUE) or from the Test payment system (FALSE).<\/td>\n<\/tr>\n
eventCode<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe value ORDER_OPENED<\/code>.<\/td>\n<\/tr>\n
pspReference<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe reference we assigned to the order. This is guaranteed to be globally unique and is used when communicating with us about this payment.<\/td>\n<\/tr>\n
merchantReference<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThis reference you assigned to the order\/ payment request.<\/td>\n<\/tr>\n
merchantAccountCode<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe merchant account the order was created for.<\/td>\n<\/tr>\n
eventDate<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe time the order was generated.<\/td>\n<\/tr>\n
success<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nAlways true.<\/td>\n<\/tr>\n
amount<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe amount of the order.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Authorize payments<\/h3>\n

For each payment you receive an\u00a0AUTHORISATION<\/code>\u00a0webhook event\u00a0with the\u00a0merchantReference<\/code>\u00a0and\u00a0pspReference<\/code>\u00a0numbers. In the case of multiple partial payments, you receive multiple\u00a0AUTHORISATION\u00a0<\/code>events\u00a0with the same\u00a0merchantReference<\/code>\u00a0and\u00a0pspReference<\/code>\u00a0numbers corresponding to each partial payment.<\/p>\n

Close an order<\/h3>\n

After the full order amount is paid, you receive a\u00a0ORDER_CLOSED<\/code>\u00a0webhook event. This event has the same\u00a0pspReference<\/code>\u00a0as you received in the\u00a0ORDER_OPENED<\/code>\u00a0event. The\u00a0success<\/code>\u00a0value for this event is true<\/strong>.<\/p>\n

It is also possible that the last payment is refused or the browser is closed before the total order amount is paid. In this case, the order expires when the\u00a0sessionValidity<\/code>\u00a0date\/time has been met in the payment request, and you receive a\u00a0ORDER_CLOSED<\/code>\u00a0webhook\u00a0event, but with the\u00a0success<\/code>\u00a0value set to false. All partial payments that were processed previously are automatically cancelled or refunded. For more details see the\u00a0Adyen API Manual.<\/p>\n

Testing<\/h2>\n

Partial payments can be tested via the Adyen Test system:<\/p>\n

    \n
  1. Activate partial payments\u00a0on your skin, and wait until your skin is up to date on all Test systems.<\/li>\n
  2. Create a normal payment request, for example, for EUR 10.00.<\/li>\n
  3. Select one of the supported partial payment methods, for example,\u00a0Plastix.<\/li>\n
  4. Enter in the card details. The test details are available on our support website.\u00a0
    \nFor Plastix it is; cardholder: card number: 4010100000000000000 pin: 73737. By specifying the cardholder name as 'balance EUR 100' you can force that the balance on the card is only EUR 1.00 (amount is specified in\u00a0minor units<\/a>).<\/li>\n
  5. Select the option that you want to pay the rest of the payment amount with another payment method if there is not enough balance.<\/li>\n
  6. After the payment is authorised you are redirected back to the Hosted Payment Page. You now do another partial payment or finalize the order by completing payment (in our example EUR 9.00).<\/li>\n
  7. After the last payment is authorised you are redirected back to the result URL.<\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request\/partial-payments","articleFields":{"id":"24217178","type":"page","_expandable":{"operations":""},"status":"current","parameters":{"anchor_new":"Partial payments<\/a>","parent_page":"classic Hosted Payment Pages (HPP)","new_desc":"using Checkout API"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request\/partial-payments","title":"Partial payments using Hosted Payment Pages","content":"\nHosted Payment Pages are no longer available\nTo accept payments through an Adyen-hosted page, use our Hosted Checkout.\nThis page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life. We are no longer processing transactions though HPP.\n\nA flexible, secure and easy way to allow your customers to pay for your goods or services. When a shopper needs to pay to complete an order they are transferred from your site to the HPP where the customer performs the payment. The shopper is then directed back to your site along with the result of the payment.\u00a0\nIn some\u00a0cases,\u00a0you may want for a shopper to pay the full payment amount via multiple payment methods. This is called partial payments: a single payment request that is paid via multiple payment methods.\u00a0\nThe first until the second-last partial payment can be one of the following payment methods:\u00a0\n\n\n\n\n\n\n\n\n\nPayment Method\nValue\n\n\nWebshop Giftcard\nwebshopgiftcard\n\n\nVVV Giftcard\nvvvgiftcard\n\n\nOther giftcards\n-\n\n\n\nThe last partial payment must always be a payment method which has a direct\/online result. Below a list of all supported payment methods:\u00a0\n\n\n\n\n\n\n\n\n\nPayment Method\nValue\n\n\nVisa\nvisa\n\n\nMastercard\nmc\n\n\nAmex\namex\n\n\niDEAL\nideal\n\n\nWebshop Giftcard\nwebshopgiftcard\n\n\nVVV Giftcard\nvvvgiftcard\n\n\n\nPayment methods like bank transfers are not supported as these do not have an online result.\nSkin settings\nTo enable partial payments, in the\u00a0Skin Options\u00a0drop-down, activate the\u00a0Support partial payments\u00a0option on the skin you use with Adyen via\u00a0Customer Area.\u00a0\nFinish by clicking the\u00a0Save Skin to Test\u00a0button.\nPayment Selection\nBefore processing the first partial payment an order is created. Like a normal payment, this order has a unique\u00a0pspReference.\u00a0All partial payments are available in the\u00a0Payment List\u00a0as normal payments. The merchant reference for the partial payments of one order are the same.\nAfter a partial payment the shopper is redirected back to the HPP to pay for the pending amount. The second payment can also be a partial payment of the amount that is pending.\u00a0The sum of the payment amounts of the partial payments for one order should be the same as the total amount of the order (if all payments were successful).\nThere isn't any maximum number of partial payments for a single payment request.\nYou can add a custom\u00a0Column Configuration\u00a0in the Payment list. In this custom configuration, you can add the\u00a0Order Reference\u00a0column. This column contains the\u00a0pspReference\u00a0as submitted back in the\u00a0ORDER_OPEN\u00a0and the\u00a0ORDER_CLOSED\u00a0webhook events.\nWebhooks\nOpen an order\nIf the first payment for your payment request is a partial payment, an order is created. This generates an\u00a0ORDER_OPENED\u00a0webhook event. The following fields are sent in this event:\n\n\n\nField\nRequired\nDescription\n\n\n\n\nlive\n\nBoolean indicating if the event originated from the Live payment system (TRUE) or from the Test payment system (FALSE).\n\n\neventCode\n\nThe value ORDER_OPENED.\n\n\npspReference\n\nThe reference we assigned to the order. This is guaranteed to be globally unique and is used when communicating with us about this payment.\n\n\nmerchantReference\n\nThis reference you assigned to the order\/ payment request.\n\n\nmerchantAccountCode\n\nThe merchant account the order was created for.\n\n\neventDate\n\nThe time the order was generated.\n\n\nsuccess\n\nAlways true.\n\n\namount\n\nThe amount of the order.\n\n\n\nAuthorize payments\nFor each payment you receive an\u00a0AUTHORISATION\u00a0webhook event\u00a0with the\u00a0merchantReference\u00a0and\u00a0pspReference\u00a0numbers. In the case of multiple partial payments, you receive multiple\u00a0AUTHORISATION\u00a0events\u00a0with the same\u00a0merchantReference\u00a0and\u00a0pspReference\u00a0numbers corresponding to each partial payment.\nClose an order\nAfter the full order amount is paid, you receive a\u00a0ORDER_CLOSED\u00a0webhook event. This event has the same\u00a0pspReference\u00a0as you received in the\u00a0ORDER_OPENED\u00a0event. The\u00a0success\u00a0value for this event is true.\nIt is also possible that the last payment is refused or the browser is closed before the total order amount is paid. In this case, the order expires when the\u00a0sessionValidity\u00a0date\/time has been met in the payment request, and you receive a\u00a0ORDER_CLOSED\u00a0webhook\u00a0event, but with the\u00a0success\u00a0value set to false. All partial payments that were processed previously are automatically cancelled or refunded. For more details see the\u00a0Adyen API Manual.\nTesting\nPartial payments can be tested via the Adyen Test system:\n\nActivate partial payments\u00a0on your skin, and wait until your skin is up to date on all Test systems.\nCreate a normal payment request, for example, for EUR 10.00.\nSelect one of the supported partial payment methods, for example,\u00a0Plastix.\nEnter in the card details. The test details are available on our support website.\u00a0\nFor Plastix it is; cardholder: card number: 4010100000000000000 pin: 73737. By specifying the cardholder name as 'balance EUR 100' you can force that the balance on the card is only EUR 1.00 (amount is specified in\u00a0minor units).\nSelect the option that you want to pay the rest of the payment amount with another payment method if there is not enough balance.\nAfter the payment is authorised you are redirected back to the Hosted Payment Page. You now do another partial payment or finalize the order by completing payment (in our example EUR 9.00).\nAfter the last payment is authorised you are redirected back to the result URL.\n","type":"page","locale":"pt","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Hosted Payment Pages","lvl4":"Payment request for Hosted Payment Pages","lvl5":"Partial payments using Hosted Payment Pages"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages","lvl4":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request","lvl5":"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request\/partial-payments"},"levels":6,"category":"Online Payments","category_color":"green","tags":["Partial","payments","using","Hosted","Payment","Pages"]}}