# 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)](/api-reference/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](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| city | string | Yes | [Business location city](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| district | string | Yes | [Business location district](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| village | string | Yes | [Business location village](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| postal\_code | string | Yes | [Business location postal code](/api-reference/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](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_city | string | Yes | [PIC location city](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_district | string | Yes | [PIC location district](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_village | string | Yes | [PIC location village](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| pic\_postal\_code | string | Yes | [PIC location postal code](/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration/get-address.md). |
| bank | string | Yes | [Bank code](/api-reference/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](/api-reference/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: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.finpay.id/api-reference/mitra-finpay/merchant-acquiring-partner-api/registration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.