QRIS Migration API

The QRIS Migration API is designed for users who already have a QRIS (Quick Response Code Indonesian Standard) and want to migrate their QRIS information to Zipay.

Endpoint URL

https://api.zipay.co.id/merchant/migrate

Request

URL: https://api.zipay.co.id/merchant/migrate
Method: POST
Headers:
- Content-Type: application/json
- Authorization: Bearer <YOUR_BEARER_TOKEN>

Request Body

Field	Mandatory	Description	Note
fullName	Yes	The full name of the individual or business owner.
businessName	Yes	The name of the business.
mpan	Yes	The Merchant PAN (Primary Account Number). This is a unique identifier for the merchant's account.
mid	Yes	The Merchant ID assigned by the current QRIS provider.
categoryId	Yes	The category ID of the business.	Click here to view the category IDs
criteriaId	Yes	The criteria ID for the migration.	Click here to view the criteria IDs
stateId	Yes	The ID representing the state where the business is located.	Click here to view the state IDs
cityId	Yes	The ID representing the city where the business is located.	Click here to view the city IDs
subdistrictId	Yes	The ID representing the subdistrict where the business is located.	Click here to view the subdistrict IDs
villageId	Yes	The ID representing the village where the business is located.	Click here to view the village IDs
type	Yes	The type of entity migrating the QRIS (e.g., INDIVIDUAL or BUSINESS).

Example Request

{
  "fullName": "VIRA YULIANA",
  "businessName": "ZHX GUITAR STORE",
  "mpan": "9360082500814951041",
  "mid": "ZPM193031118802",
  "categoryId": "6532",
  "criteriaId": "UMI",
  "stateId": "11",
  "cityId": "159",
  "subdistrictId": "1997",
  "villageId": "25739",
  "type": "INDIVIDUAL"
}

Response

Example Response

{
  "status": 200,
  "success": true,
  "data": {
    "merchant": {
      "merchantId": 3,
      "merchantKey": "a1398c51-ed9c-48f9-954c-80b8d93963c6",
      "fullName": "VIRA YULIANA",
      "mid": "ZPM142031234617",
      "mpan": "9360082500823836936",
      "status": "NON ACTIVE",
      "qrString": "00020101021126640012ID.ZIPAY.WWW01189360082500823836930215ZPM1420312346170303UMI51420012ID.ZIPAY.WWW0215ZPM1420312346170303UMI5204653253033605802ID5917ZHX GUITAR STORE36015JAKARTA SELATAN61051214062140510QRST-5130363049DAA"
    },
    "message": "Success Register Merchant"
  }
}

Field	Description
status	HTTP status code of the response. A value of `200` indicates that the request was successful.
success	A boolean value indicating whether the request was successful (`true`) or not (`false`).
data.merchant	Object with details of the migrated merchant:
data.merchant.merchantId	A unique identifier for the merchant in the Zipay system.
data.merchant.merchantKey	A unique key associated with the merchant, used for authentication and identification purposes.
data.merchant.fullName	The full name of the merchant or business owner.
data.merchant.mid	The Merchant ID assigned by Zipay.
data.merchant.mpan	The Merchant PAN (Primary Account Number) used to identify the merchant's account.
data.merchant.status	The current status of the merchant account (e.g., `ACTIVE`,`PENDING`,`NON ACTIVE`,`FREEZE`).
data.merchant.qrString	A QR code string representing the merchant, used for generating QR codes for transactions.
message	A message providing additional information about the result of the request, such as "Success Register Merchant".