No momento, esta página não está disponível em português
Online-payment icon

Partial payments

Let your shoppers make a purchase with multiple payment methods.

The /orders endpoint lets you combine different payment methods when a shopper makes a payment. For example, a shopper can use a gift card with a balance lower than the amount of the purchase and pay the remaining amount with a credit card.

To accept partial payments with different payment methods, you must create an order, make payments, and complete the order or cancel the order.

Create an order

  1. Make a POST /orders request, and specify:

    Parameter Required Description
    amount -white_check_mark- The currency and full value of the order.
    reference -white_check_mark- Your unique identifier for this order.
    expiresAt The automatic expiry time for the order. If not provided, the order expires 24 hours after the creation date. The expiresAt field is specified in ISO 8601. For example, 2019-01-01T14:21:00.
  2. The response contains the following fields that you need to make payments:

    You also get an ORDER_OPENED webhook event when the order has been created.

Make a payment

  1. Make a POST /payments request including:

    Parameter Required Description
    amount -white_check_mark- The payment amount. If this is less than the remainingAmount from the /orders response, it is a partial payment.
    paymentMethod -white_check_mark- The payment method.
    order.pspReference -white_check_mark- The pspReference from the /orders response.
    order.orderData -white_check_mark- The orderData from the /orders response.

    In case of a redirect payment method such as iDEAL, you need to handle the redirect

  2. The response contains an order object that shows the remaining amount required on the order. You also get a new orderData value that you must include in your next payment request.

Completing an order

After making enough partial payments to pay the full order amount, you get a response with the remainingAmount.value of 0.

A remaining amount of 0 does not indicate that the order has been completed. The order has been completed when all payments in the order have reached a final payment status, and we send an ORDER_CLOSED webhook with the success value true.

Cancel an order

We automatically cancel an order that has not been completed and has a remaining amount greater than 0 when it reaches the expiry time.

You can also manually cancel an incomplete order. When you manually cancel an order, all the previous payments for that order are either canceled or refunded, depending on the type of payment method.

Make a /orders/cancel request including:

Parameter Required Description
order.pspReference -white_check_mark- The pspReference from the /orders response.
order.orderData -white_check_mark- The orderData from the most recent /orders response.

When an order has been canceled, we send an ORDER_CLOSED webhook event with the success value false.

Cancel a completed order

If you want to cancel an order that has the remaining amount of 0, you can do either:

See also