Import payment data from another payment provider

Unipaas allows you to retain all your existing payments data when you migrate to Unipaas. We work with your current payment provider to securely migrate the payments data.

Requirements

Migrating the payments data requires you to:

1. Adjust your technical process so that tokenisation and recurring charge processes can be performed by your current provider and Unipaas simultaneously.
   • New tokenisations/sign-ups should be using Unipaas
   • Recurring charges to be continued to be done with your current payment provider.
2. Contact your current payment provider and request the payments data (most processors require the account holder to request the data transfer). You will need to provide the following:
   • Link to Unipaas PGP key: https://docs.unipaas.com/docs/protect-sensitive-data-with-pgp-key
   • Support email: support@unipaas.com
3. Send the data to support@unipaas.com and request the data to be imported.
4. Update your integration to map the current payment providers ID's with the Unipaas' paymentOptionId using the export file or Unipaas webhooks.
5. Switch all charge processes for old customers to Unipaas.

Update your integration

After completing the import, Unipaas sends you webhooks with updates.

• Handle paymentOption/update webhook
  After successful import of each payment method, UNIPaaS sends an paymentOption/update webhook to your server with mapped relationship between your current processor's ID and the paymentOptionId in the metadata. This data should be used to update your database so that all future payments are done using Unipaas.
  1. Extract and store the paymentOption.id against the customer reference in your system.This ID is token of the payment method and used for initiating future MITs (Merchant Initiated Transactions).
  2. Switch over and use paymentOption.id for future MITs.

Webhook Payload Example:

{
  "id": "67e10684a1666bdf37c5380b",
  "paymentOptionId": "67e10684a1666bdf37c5380b",
  "paymentOptionType": "card",
  "identity": "67e10684a1666bdf37c53809",
  "consumerId": "67e10684a1666bdf37c53809",
  "identityType": "consumer",
  "cardAccount": {
    "holderName": "Test Holder Name",
    "expiryYear": "30",
    "expiryMonth": "12",
    "number": "5032",
    "issuerCountry": "GB",
    "lastFourDigits": "5032",
    "bin": "400002",
    "brand": "VISA",
    "type": "Credit",
    "program": "Visa Traditional"
  },
  "merchantId": "605c8a4b8b37a82b60f0752d",
  "metadata": {
    "stripeRegisteredEmail": "consumer@mail.com",
    "stripeId": "123123",
    "stripeCardId": "123123",
    "customerReference": ""
  }
}