GoPay Drop-in integration

Add GoPay to your existing iOS Drop-in integration.

On this page, you can find additional configuration for adding GoPay to your iOS Drop-in integration.

Before you begin

This page assumes you have already:

API reference

Select which endpoint you're integrating:

This is the default with iOS Drop-in v5.0.0 or later.

Parameter name	Required	Description
browserInfo		Information about the shopper's browser.
channel		Set to Web.

Drop-in configuration

There is no required GoPay-specific integration for iOS Drop-in.

Recurring payments

GoPay supports recurring transactions. To make recurring transactions, you need to:

Create a shopper token.
Use the token to make future payments for the shopper.

Create a token

To create a token, include in your /payments request:

storePaymentMethod: true
shopperReference: Your unique identifier for the shopper (minimum length three characters).

When the payment has been settled, you receive a webhook containing:

eventCode: RECURRING_CONTRACT
originalReference: The pspReference of the initial payment.
pspReference: This is the token that you need to make recurring payments for this shopper.

Make sure that your server is able to receive RECURRING_CONTRACT as part of your standard webhooks. You can enable the RECURRING_CONTRACT event code in the webhook settings page.

Make a payment with a token

To make a recurring with a token, make a /payments request and include:

paymentMethod.storedPaymentMethodId: The shopper's payment token.

You can also get this value by using the /listRecurringDetails endpoint.
shopperReference: Your unique identifier for the shopper.
shopperInteraction: ContAuth.
recurringProcessingModel: Subscription.

Test and go live

When you want to test GoPay, contact our Support Team.

Refer to GoPay's knowledge base for more information about testing GoPay payments.

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