Payone: Integration in the Back Office

Last updated:
Edit on GitHub

The Payone app lets your customers make payments with common payment methods, such as credit card and PayPal.

Info

We support only credit card and PayPal payment methods for Payone. If you want to use either or both of these payment methods, you must have them in your Payone contract. However, even if your contract with Payone includes other payment methods, you can not use them, as we do not support them yet.

You can have multiple accounts with Payone. For example, you can have different Payone credentials per store, which we support as well.

Payment method modes

For the Payone Credit Card payment method, we support the following modes:

  • Preauthorization and Capture: After a customer entered the credit card details during the checkout, the seller preauthorizes or reserves the payable amount on the customer’s credit card. As soon as the items have shipped, this amount is captured. Capture kicks off the process of moving money from the customer’s credit card to the seller’s account. The preauthorization and capture mode is the best choice for physical goods. It ensures that in case the ordered items are not available anymore or the customer cancels the order before it is shipped, the seller does not have to transfer the money back to the customer’s account and thereby avoids a chargeback.
  • 3DS: Messaging protocol that enables consumer authentication with their card issuer when making online purchases.
  • PCI DSS Compliance via SAQ A: A set of security standards designed to ensure that you accept, process, and transmit credit card information in a secure environment.

For the Payone Paypal payment method, we support only Preauthorization and Capture.

State machine for Payone

The payment modes like Preauthorization and Capture must be set via the Spryker state machine in the Order Management System (OMS). However, the state machine for the Payone app is now in development, so you can not customize it for your project yet.

Credit card payment flow

When customers pay with a credit card (with optional support of 3DS), the flow is as follows:

  1. Customer provides their credit card payment credentials and pays the required amount for the placed order.
  2. The customer’s credit card data is validated.
  3. Customer receives a payment message, whether the payment or authorization was successful.

When paying with a credit card, customers can do the following:

  • Repeat payments as often as they want if the payment (preauthorization) has failed, or cancel and close the payment page.
  • Cancel the entire order before shipment and receive the money back, that is, void the existing preauthorization without being charged a fee.
  • Cancel the order after it is ready for shipment and receive the money back, that is, trigger a refund.
  • Return the order or its items after it has been successfully shipped and is refunded for the returned items or the entire order.

When customers pay with a credit card, a shop owner can do the following:

  • Charge customers once the order is ready to be shipped, that is, capture the funds.
  • Cancel the entire customer order, that is, void the existing preauthorization. In this case, the customer is not charged anything.
  • Cancel one or more items of a customer’s order before shipment. The customer is not charged for the canceled items.

PayPal payment flow

When customers pay with PayPal, the flow is as follows:

  1. Customer is redirected to the PayPal website, where they have to log in.
  2. On the PayPal website, the customer either cancels or validates the transaction.
  3. Customer is taken to the checkout page with the message of either a successfully placed or canceled order.

When paying with PayPal, customers can:

  • Cancel the entire order before shipment and receive the money back, that is, void the existing preauthorization, without being charged a fee.
  • Cancel the order after it is ready for shipment and receive the money back, that is, trigger a refund.
  • Return the order or its items after it has been successfully shipped and is refunded for the returned items or the entire order.

When customers pay with PayPal, a shop owner can do the following:

  • Charge customers once the order is ready to be shipped, that is, capture the funds.
  • Cancel the entire customer order, that is, void the existing preauthorization. In this case, the customer is not charged anything.
  • Cancel one or more items of a customer’s order before shipment. The customer is not charged for the canceled items.

Next steps

Integrate Payone