Payment upon shipment is a custom card payment use case that allows you to debit the customer only after the product is delivered. This is especially useful for merchants who only want to charge customers once the goods have been shipped, ensuring better customer experience and reducing potential disputes.

Implementation workflow

1. Initial payment request: The customer is authenticated for the full order amount, but the transaction is authorized with a zero amount. The customer’s card details, along with the authentication data, are securely stored within for use in a subsequent payment request.
2. Save reference data: Save the reference data such as payId received in the response in order to submit in the subsequent payment request.
3. Confirm payment request: Once the product is shipped, a follow-up request is initiated to authorize the customer’s card for the actual order amount.

Initial payment request

You can initiate the initial payment request for a Payment upon shipment use case by passing paymentMethods.card.eventToken=DELAYED_SHIPMENT in your request payload.

Initial payment request is supported in all the 3 integration types: Hosted payment page, Hosted forms and Direct integration.

Save reference data

Save the payId received in the response. If you are using Hosted Payment Page or Hosted forms integration, validate the status of the initial payment request by calling Retrieve payment details by Payment ID before saving the payId.

Confirm payment request

Once the product is shipped, initiate a Confirm payment using the payId returned in the initial transaction response and paymentMethods.card.eventToken=DELAYED_SHIPMENT. This authorizes the customer's card for the full order amount.