Payment-method icon

PaySafeCard Drop-in integration

Add PaySafeCard to an existing Drop-in integration.

If you are using Android Drop-in v5.0.0 or later:

This payment method requires no additional configuration.

Follow the Drop-in integration guide.

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

Requirements

Requirement Description
Integration type Make sure that you have built an Advanced flow Android Drop-in integration.
Setup steps Before you begin, contact our Support Team to add 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 in your live Customer Area.

See also