> For the complete documentation index, see [llms.txt](https://docs.finpay.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.finpay.id/mitra-finpay/merchant-acquiring-partner-api/registration.md).
# Registration
#### /register-full/
Method: POST\
Max Expected Response Time: 60 seconds\
Max Request Size: 10 MB
**Header**
| Key | Value | Mandatory |
| ------------- | ---------------- | --------- |
| Accept | application/json | Yes |
| Authorization | Bearer | Yes |
**Request Body**
| Field | Type | Mandatory | Description |
| ---------------------------- | ------ | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| lat | string | Yes | Latitude. |
| long | string | Yes | Longitude. |
| tipe | string | Yes | `1` for personal or `2` for business. |
| tipe\_b | string | Yes (`tipe = 2`) | `cv/firma`, `pt/yayasan/koperasi`, or `lainnya`. |
| lainnya | string | Yes (`tipe\_b = lainnya`) | Other organization type. |
| referral\_code | string | Yes | Referral code. |
| acquired\_by | string | No | Acquisition partner code or merchant aggregator code. |
| merchant\_name | string | Yes | Merchant name. |
| merchant\_criteria | string | Yes | Merchant criteria: `UMI`, `UKE`, `UME`, `URE`, `UBE`, `BLU`, `PSO`. |
| merchant\_category | int | Yes | [Merchant category (MCC)](/mitra-finpay/merchant-acquiring-partner-api/reference/registration-data.md). |
| instagram\_u | string | No | Instagram username. |
| website\_u | string | No | Website address. |
| facebook\_u | string | No | Facebook username. |
| lainnya\_u | string | No | Other social media account. |
| jumlah\_outlet | string | Yes | Number of terminals. |
| open\_hour | string | Yes | Merchant opening hour. |
| close\_hour | string | Yes | Merchant closing hour. |
| merchant\_address | string | Yes | Merchant address. |
| rt\_merchant | string | Yes | RT of the business location. |
| rw\_merchant | string | Yes | RW of the business location. |
| province | string | Yes | [Business location province](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| city | string | Yes | [Business location city](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| district | string | Yes | [Business location district](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| village | string | Yes | [Business location village](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| postal\_code | string | Yes | [Business location postal code](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_name | string | Yes | PIC name. |
| ktp\_number | string | Yes | PIC KTP number. |
| npwp\_number | string | Yes | PIC NPWP number. |
| kk\_number | string | Yes | PIC family card number. |
| phone\_number | string | Yes | PIC phone number. |
| email | string | Yes | PIC email. |
| pic\_address | string | Yes | PIC address. |
| rt\_pic | string | Yes | RT of the PIC location. |
| rw\_pic | string | Yes | RW of the PIC location. |
| pic\_province | string | Yes | [PIC location province](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_city | string | Yes | [PIC location city](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_district | string | Yes | [PIC location district](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_village | string | Yes | [PIC location village](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_postal\_code | string | Yes | [PIC location postal code](/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| bank | string | Yes | [Bank code](/mitra-finpay/merchant-acquiring-partner-api/reference/registration-data.md). |
| bank\_number | string | Yes | Bank account number for settlement. |
| bank\_name | string | Yes | Bank account holder name. |
| cabang\_bank | string | Yes | Bank branch. |
| manual\_settlement | bool | No (default `false`) | `true` or `false`. |
| ktp\_image | string | Yes | Base64 string or URL for the KTP image. |
| npwp\_image | string | Yes | Base64 string or URL for the NPWP image. |
| cover\_buku\_tabungan\_image | string | Yes | Base64 string or URL for the bank book cover image. |
| lokasi\_usaha\_image | string | Yes | Base64 string or URL for the business location image. |
| website\_image | string | Yes | Base64 string or URL for the business website or social media image. |
| kk\_image | string | Yes | Base64 string or URL for the family card scan or photo. |
| akta\_pendirian\_image | string | Yes (`tipe = 2`, `tipe\_b = cv/firma` or `pt/yayasan/koperasi`) | Base64 string or URL for the business deed of establishment document. |
| akta\_perubahan\_image | string | Yes (`tipe = 2`, `tipe\_b = cv/firma` or `pt/yayasan/koperasi`) | Base64 string or URL for the amended articles of association document. |
| keterangan\_terdaftar\_image | string | Yes (`tipe = 2`, `tipe\_b = cv/firma` or `pt/yayasan/koperasi`) | Base64 string or URL for the tax registration certificate document. |
| identitas\_persero\_image | string | Yes (`tipe = 2`, `tipe\_b = cv/firma`) | Base64 string or URL for the active partner identity document. |
| domisili\_image | string | Yes (`tipe = 2`) | Base64 string or URL for the domicile certificate document. |
| nib\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the business identification number document. |
| siup\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the business license document. |
| wakil\_hukum\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the legal representative identity document. |
| kuasa\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the power of attorney document. |
| kuasa\_identitas\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the authorized recipient identity document. |
| akta\_anggaran\_image | string | Yes (`tipe = 2`, `tipe\_b = pt/yayasan/koperasi`) | Base64 string or URL for the articles of association document. |
| struktur\_organisasi\_image | string | Yes (`tipe = 2`, `tipe\_b = lainnya`) | Base64 string or URL for the organization structure document. |
| penetapan\_tugas\_image | string | Yes (`tipe = 2`, `tipe\_b = lainnya`) | Base64 string or URL for the duty assignment document. |
**Response Body**
| Field | Type | Description |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| merchant\_id | string | Merchant ID. |
| rc | string | [Response code](/mitra-finpay/merchant-acquiring-partner-api/reference/response-code.md) (`00`, `01`, `20`, `30`, `40`). |
| message | string | Response message. |
#### Registration status callback
Sent to the partner when the merchant registration or status changes.
**Request Body**
| Field | Type | Description |
| ------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| merchant\_id | string | Merchant ID. |
| nmid | string | National Merchant ID. |
| status | int | `1` = in process / waiting for PTEN, `2` = approved / active, `3` = rejected / blocked, `5` = caring, `6` = revision, `7` = hold settlement. |
| notes | string | Notes related to the status. |
| rc | string | Response code. |
| message | string | Response message. |
## POST /register-full/
> Register Full
```json
{"openapi":"3.0.1","info":{"title":"MF - H2H Prod v1 sama mitra","version":"1.0.0"},"security":[],"paths":{"/register-full/":{"post":{"summary":"Register Full","deprecated":false,"description":"","tags":[],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"phone_number":{"type":"string"},"email":{"type":"string"},"lat":{"type":"string"},"long":{"type":"string"},"tipe":{"type":"string"},"tipe_b":{"type":"string"},"lainnya":{"type":"string"},"referral_code":{"type":"string"},"acquired_by":{"type":"string"},"merchant_name":{"type":"string"},"merchant_criteria":{"type":"string"},"merchant_category":{"type":"string"},"instagram_u":{"type":"string"},"website_u":{"type":"string"},"facebook_u":{"type":"string"},"lainnya_u":{"type":"string"},"jumlah_outlet":{"type":"integer"},"open_hour":{"type":"string"},"close_hour":{"type":"string"},"merchant_address":{"type":"string"},"rt_merchant":{"type":"string"},"rw_merchant":{"type":"string"},"province":{"type":"string"},"city":{"type":"string"},"district":{"type":"string"},"village":{"type":"string"},"postal_code":{"type":"string"},"pic_name":{"type":"string"},"ktp_number":{"type":"string"},"npwp_number":{"type":"string"},"kk_number":{"type":"string"},"pic_address":{"type":"string"},"rt_pic":{"type":"string"},"rw_pic":{"type":"string"},"pic_province":{"type":"string"},"pic_city":{"type":"string"},"pic_district":{"type":"string"},"pic_village":{"type":"string"},"pic_postal_code":{"type":"string"},"bank":{"type":"string"},"bank_number":{"type":"string"},"bank_name":{"type":"string"},"cabang_bank":{"type":"string"},"manual_settlement":{"type":"boolean"},"ktp_image":{"type":"string"},"npwp_image":{"type":"string"},"cover_buku_tabungan_image":{"type":"string"},"lokasi_usaha_image":{"type":"string"},"website_image":{"type":"string"},"kk_image":{"type":"string"},"akta_pendirian_image":{"type":"string"},"akta_perubahan_image":{"type":"string"},"keterangan_terdaftar_image":{"type":"string"},"identitas_persero_image":{"type":"string"},"domisili_image":{"type":"string"},"nib_image":{"type":"string"},"siup_image":{"type":"string"},"wakil_hukum_image":{"type":"string"},"kuasa_image":{"type":"string"},"kuasa_identitas_image":{"type":"string"},"akta_anggaran_image":{"type":"string"},"struktur_organisasi_image":{"type":"string"},"penetapan_tugas_image":{"type":"string"}},"required":["phone_number","email","lat","long","tipe","tipe_b","lainnya","referral_code","acquired_by","merchant_name","merchant_criteria","merchant_category","instagram_u","website_u","facebook_u","lainnya_u","jumlah_outlet","open_hour","close_hour","merchant_address","rt_merchant","rw_merchant","province","city","district","village","postal_code","pic_name","ktp_number","npwp_number","kk_number","pic_address","rt_pic","rw_pic","pic_province","pic_city","pic_district","pic_village","pic_postal_code","bank","bank_number","bank_name","cabang_bank","manual_settlement","ktp_image","npwp_image","cover_buku_tabungan_image","lokasi_usaha_image","website_image","kk_image","akta_pendirian_image","akta_perubahan_image","keterangan_terdaftar_image","identitas_persero_image","domisili_image","nib_image","siup_image","wakil_hukum_image","kuasa_image","kuasa_identitas_image","akta_anggaran_image","struktur_organisasi_image","penetapan_tugas_image"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"merchant_id":{"type":"string"},"rc":{"type":"string"},"message":{"type":"string"}},"required":["merchant_id","rc","message"]}}},"headers":{}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.finpay.id/mitra-finpay/merchant-acquiring-partner-api/registration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.