Migration - Peere

Banks can migrate existing customers to Peere in batches. Providers can do the same for merchants.

Migrating Customers (Banks)

Send a POST to /v1/bank/customers with an array of customer objects.

{
  "customers": [
    {
      "clientRef": "CUST001",
      "firstname": "John",
      "lastname": "Doe",
      "accountName": "John Doe",
      "email": "john.doe@example.com",
      "country": "NG",
      "accountNumber": "1234567890",
      "reference": "ACC001"
    }
  ]
}

The response includes a batchId, a processing status, and a summary with counts for successful, failed, and duplicate records. For batches over a certain size, failures are returned as a downloadable CSV rather than inline. After migration, link customer devices using POST /v1/bank/customer/device/link to enable merchant discovery.

Migrating Merchants (Providers)

Send a POST to /v1/provider/merchants with an array of merchant objects. After creation, set appropriate trust levels for each merchant via PATCH /v1/provider/merchant/trust. Migrate in batches of 100 or fewer and add a short delay between requests to avoid rate limits.

​Migrating Customers (Banks)

​Migrating Merchants (Providers)

Migrating Customers (Banks)

Migrating Merchants (Providers)