Payment-method icon

PayPo Redirect Component

Add PayPo to your existing iOS Components integration.

This page explains how to add PayPo to your existing iOS Components integration.

Requirements

Select the server-side flow that your integration uses:

Requirement Description
Integration type Make sure that you have built a Sessions flow iOS Components integration.
Setup steps Before you begin, add PayPo in your Customer Area.

API reference

Select which endpoint you are using:

This is the default with Components v5.0.0 or later.

Parameter name Required Description
shopperEmail -white_check_mark- The shopper's email address.
shopperName -white_check_mark- The shopper's firstName and lastName.
billingAddress The shopper's billing address.
deliveryAddress The delivery address for the goods purchased.

Capture the payment

When a payment is made, but not yet authorized, the offer will be available for up to 72 hours. Therefore, the shopper can use the link to the payment for up to 72 hours.

When the payment is accepted by the shopper, its status will change to Authorised. The shopper has 30 days to pay according to the terms of PayPo. This is different to some other payment methods where the payment term usually starts after the capture, not after the authorization.

After the payment is authorized, you also have to capture the payment.

  • It is only possible to capture the full amount of the authorized payment.
  • It is possible to configure an automatic capture, which executes immediately after authorization. Configure automatic capture when adding PayPo in your live Customer Area.
  • The merchant does not have to wait for the shopper to complete their payment to PayPo to be funded for the transaction. After the payment is captured, the merchant is funded the full amount of the payment. This is because the capture is only possible for the full amount.
  • To perform the capture, send a request to /payments/{paymentPspReference}/captures using the PSP Reference of the original payment:

    Example /captures request
    Expand view
    Copy link to code block
    Copy code
    Copy code
    curl https://checkout-test.adyen.com/v71/payments/CLB738LDH8PQ7RT5/captures \
    -H "x-API-key: ADYEN_API_KEY" \
    -H "content-type: application/json" \
    -d '{
    "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
    "amount": {
    "value": 1000,
    "currency": "PLN"
    },
    "reference": "YOUR_UNIQUE_REFERENCE"
    }'

Component configuration

v5.0.0 or later

If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the PayPo Component:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
let paymentMethods = session.sessionContext.paymentMethods
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("paypo")) else { return }
let component = InstantPaymentComponent(paymentMethod: paymentMethod,
context: context,
order: nil)
self.currentComponent = component
// Set the session as the delegate.
component.delegate = session
component.initiatePayment()

v4.x.x

If your integration uses an earlier version of iOS Components:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: PayPoPaymentMethod.self) else { return }
let style = FormComponentStyle()
let component = PayPoComponent(paymentMethod: paymentMethod,
apiContext: context,
style: style)
present(component)

There are no configuration steps specific to PayPo required for Components.

Test and go live

When you test PayPo in your test environment, use the following values for the required parameters:

firstName: name
lastName: surname
shopperEmail: email@gmail.com

When you are redirected to PayPo and asked for a verification code, use 123456.

Check the status of PayPo test payments in your Customer Area > Transactions > Payments.

Before you can accept live PayPo payments, you need to submit a request for PayPo in your live Customer Area.

See also