Payment-method icon

PaySafeCard Drop-in integration

Add PaySafeCard to an existing Drop-in integration.

Our Android Drop-in renders PaySafeCard in your payment form, and redirects the shopper to the PaySafeCard page to complete the payment.

Before you begin

This page explains how to add PaySafeCard to your existing Android Drop-in integration. The Android Drop-in integration works the same way for all payment methods. If you haven't done this integration yet, refer to our Drop-in integration guide.

Before starting your PaySafeCard integration:

  1. Make sure you have set up your back end implementation.
  2. Add PaySafeCard in your test Customer Area.

Show PaySafeCard in your payment form

In your /paymentMethods request, specify:

Drop-in uses this information to show the available payment methods to your shopper.

When the shopper proceeds to pay, Drop-in returns the paymentComponentData.paymentMethod. Pass the paymentComponentData.paymentMethod to your server.

Make a payment

When the shopper proceeds to pay, Drop-in returns the paymentComponentData.paymentMethod.

  1. Pass the paymentComponentData.paymentMethod to your server.

  2. From your server, make a /payments request, specifying:

    • paymentMethod: The paymentComponentData.paymentMethod from your client app.
    • shopperReference: Your reference to uniquely identify this shopper, for example user ID or account ID.

In the /payments response, note the action object. This contains the information needed to redirect the shopper.

If your integration is set up correctly, the action object is passed from your server to the client.

Check the payment result

Drop-in redirects the shopper to complete the payment. When the shopper returns back to your app, Drop-in provides the actionComponentData object.

From your server, make a POST /payments/details request providing:

  • details: The actionComponentData.details object from Drop-in.

You receive a response containing:

  • resultCode: Use this to present the payment result to your shopper.
  • pspReference: Our unique identifier for the transaction.

Test and go live

Before you go live, test your integration using the following credentials:

  • 16-digit code: 0000 0000 0990 3417

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

Before you can accept live payments, contact our Support Team to add PaySafeCard in your live Customer Area.

See also