Update Onboarding Data

curl --request PUT \
  --url https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantName": "<string>",
  "modeOfPayments": [],
  "tin": "<string>",
  "industry": "<string>",
  "serviceDescription": "<string>",
  "isBrickAndMortarStore": true,
  "address": {
    "office": {
      "city": "<string>",
      "line1": "<string>",
      "state": "<string>",
      "postalCode": "<string>",
      "contactNumber": "<string>",
      "barangay": "<string>",
      "buildingNameAndNumber": "<string>"
    }
  },
  "representatives": {
    "authorized": {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "position": "<string>",
      "middleName": "<string>",
      "tin": "<string>",
      "sss": "<string>",
      "mothersMaidenName": "<string>"
    },
    "escalation": {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "tin": "<string>",
      "sss": "<string>",
      "position": "<string>"
    }
  },
  "banks": [
    {
      "bankName": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>"
    }
  ],
  "isWantPackworksWallet": true,
  "isWantPayMayaWallet": true,
  "isWantPayMayaBankAccount": true,
  "legalName": "<string>",
  "businessHandle": "<string>",
  "incorporators": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "address": {
        "city": "<string>",
        "line1": "<string>",
        "state": "<string>",
        "postalCode": "<string>",
        "contactNumber": "<string>",
        "barangay": "<string>",
        "buildingNameAndNumber": "<string>"
      },
      "middleName": "<string>"
    }
  ],
  "signatories": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "position": "<string>",
      "middleName": "<string>"
    }
  ],
  "websites": {
    "businessWebsiteUrl": "<string>",
    "isBusinessWebsiteUnderDevelopment": true,
    "facebookUrl": "<string>",
    "twitterUrl": "<string>",
    "instagramUrl": "<string>",
    "tiktokUrl": "<string>"
  },
  "aubPartnerId": "<string>",
  "estimatedMonthlyGrossTransaction": "<string>"
}
'

import requests

url = "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}"

payload = {
    "merchantName": "<string>",
    "modeOfPayments": [],
    "tin": "<string>",
    "industry": "<string>",
    "serviceDescription": "<string>",
    "isBrickAndMortarStore": True,
    "address": { "office": {
            "city": "<string>",
            "line1": "<string>",
            "state": "<string>",
            "postalCode": "<string>",
            "contactNumber": "<string>",
            "barangay": "<string>",
            "buildingNameAndNumber": "<string>"
        } },
    "representatives": {
        "authorized": {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "position": "<string>",
            "middleName": "<string>",
            "tin": "<string>",
            "sss": "<string>",
            "mothersMaidenName": "<string>"
        },
        "escalation": {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "tin": "<string>",
            "sss": "<string>",
            "position": "<string>"
        }
    },
    "banks": [
        {
            "bankName": "<string>",
            "accountName": "<string>",
            "accountNumber": "<string>"
        }
    ],
    "isWantPackworksWallet": True,
    "isWantPayMayaWallet": True,
    "isWantPayMayaBankAccount": True,
    "legalName": "<string>",
    "businessHandle": "<string>",
    "incorporators": [
        {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "address": {
                "city": "<string>",
                "line1": "<string>",
                "state": "<string>",
                "postalCode": "<string>",
                "contactNumber": "<string>",
                "barangay": "<string>",
                "buildingNameAndNumber": "<string>"
            },
            "middleName": "<string>"
        }
    ],
    "signatories": [
        {
            "firstName": "<string>",
            "lastName": "<string>",
            "position": "<string>",
            "middleName": "<string>"
        }
    ],
    "websites": {
        "businessWebsiteUrl": "<string>",
        "isBusinessWebsiteUnderDevelopment": True,
        "facebookUrl": "<string>",
        "twitterUrl": "<string>",
        "instagramUrl": "<string>",
        "tiktokUrl": "<string>"
    },
    "aubPartnerId": "<string>",
    "estimatedMonthlyGrossTransaction": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    merchantName: '<string>',
    modeOfPayments: [],
    tin: '<string>',
    industry: '<string>',
    serviceDescription: '<string>',
    isBrickAndMortarStore: true,
    address: {
      office: {
        city: '<string>',
        line1: '<string>',
        state: '<string>',
        postalCode: '<string>',
        contactNumber: '<string>',
        barangay: '<string>',
        buildingNameAndNumber: '<string>'
      }
    },
    representatives: {
      authorized: {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        position: '<string>',
        middleName: '<string>',
        tin: '<string>',
        sss: '<string>',
        mothersMaidenName: '<string>'
      },
      escalation: {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        tin: '<string>',
        sss: '<string>',
        position: '<string>'
      }
    },
    banks: [{bankName: '<string>', accountName: '<string>', accountNumber: '<string>'}],
    isWantPackworksWallet: true,
    isWantPayMayaWallet: true,
    isWantPayMayaBankAccount: true,
    legalName: '<string>',
    businessHandle: '<string>',
    incorporators: [
      {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        address: {
          city: '<string>',
          line1: '<string>',
          state: '<string>',
          postalCode: '<string>',
          contactNumber: '<string>',
          barangay: '<string>',
          buildingNameAndNumber: '<string>'
        },
        middleName: '<string>'
      }
    ],
    signatories: [
      {
        firstName: '<string>',
        lastName: '<string>',
        position: '<string>',
        middleName: '<string>'
      }
    ],
    websites: {
      businessWebsiteUrl: '<string>',
      isBusinessWebsiteUnderDevelopment: true,
      facebookUrl: '<string>',
      twitterUrl: '<string>',
      instagramUrl: '<string>',
      tiktokUrl: '<string>'
    },
    aubPartnerId: '<string>',
    estimatedMonthlyGrossTransaction: '<string>'
  })
};

fetch('https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'merchantName' => '<string>',
    'modeOfPayments' => [
        
    ],
    'tin' => '<string>',
    'industry' => '<string>',
    'serviceDescription' => '<string>',
    'isBrickAndMortarStore' => true,
    'address' => [
        'office' => [
                'city' => '<string>',
                'line1' => '<string>',
                'state' => '<string>',
                'postalCode' => '<string>',
                'contactNumber' => '<string>',
                'barangay' => '<string>',
                'buildingNameAndNumber' => '<string>'
        ]
    ],
    'representatives' => [
        'authorized' => [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'position' => '<string>',
                'middleName' => '<string>',
                'tin' => '<string>',
                'sss' => '<string>',
                'mothersMaidenName' => '<string>'
        ],
        'escalation' => [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'tin' => '<string>',
                'sss' => '<string>',
                'position' => '<string>'
        ]
    ],
    'banks' => [
        [
                'bankName' => '<string>',
                'accountName' => '<string>',
                'accountNumber' => '<string>'
        ]
    ],
    'isWantPackworksWallet' => true,
    'isWantPayMayaWallet' => true,
    'isWantPayMayaBankAccount' => true,
    'legalName' => '<string>',
    'businessHandle' => '<string>',
    'incorporators' => [
        [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'address' => [
                                'city' => '<string>',
                                'line1' => '<string>',
                                'state' => '<string>',
                                'postalCode' => '<string>',
                                'contactNumber' => '<string>',
                                'barangay' => '<string>',
                                'buildingNameAndNumber' => '<string>'
                ],
                'middleName' => '<string>'
        ]
    ],
    'signatories' => [
        [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'position' => '<string>',
                'middleName' => '<string>'
        ]
    ],
    'websites' => [
        'businessWebsiteUrl' => '<string>',
        'isBusinessWebsiteUnderDevelopment' => true,
        'facebookUrl' => '<string>',
        'twitterUrl' => '<string>',
        'instagramUrl' => '<string>',
        'tiktokUrl' => '<string>'
    ],
    'aubPartnerId' => '<string>',
    'estimatedMonthlyGrossTransaction' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}"

	payload := strings.NewReader("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}")
  .asString();

using RestSharp;


var options = new RestClientOptions("https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}", false);
var response = await client.PutAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "onboardingStatus": "PENDING",
  "onboardingReferenceNumber": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "statusCode": 123,
  "message": "<string>",
  "error": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "message": "<string>",
  "error": "<string>",
  "details": {}
}

PUT

onboard

{refNo}

Update Onboarding Data

curl --request PUT \
  --url https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantName": "<string>",
  "modeOfPayments": [],
  "tin": "<string>",
  "industry": "<string>",
  "serviceDescription": "<string>",
  "isBrickAndMortarStore": true,
  "address": {
    "office": {
      "city": "<string>",
      "line1": "<string>",
      "state": "<string>",
      "postalCode": "<string>",
      "contactNumber": "<string>",
      "barangay": "<string>",
      "buildingNameAndNumber": "<string>"
    }
  },
  "representatives": {
    "authorized": {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "position": "<string>",
      "middleName": "<string>",
      "tin": "<string>",
      "sss": "<string>",
      "mothersMaidenName": "<string>"
    },
    "escalation": {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "tin": "<string>",
      "sss": "<string>",
      "position": "<string>"
    }
  },
  "banks": [
    {
      "bankName": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>"
    }
  ],
  "isWantPackworksWallet": true,
  "isWantPayMayaWallet": true,
  "isWantPayMayaBankAccount": true,
  "legalName": "<string>",
  "businessHandle": "<string>",
  "incorporators": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "emailAddress": "jsmith@example.com",
      "contactNumber": "<string>",
      "dateOfBirth": "2023-12-25",
      "address": {
        "city": "<string>",
        "line1": "<string>",
        "state": "<string>",
        "postalCode": "<string>",
        "contactNumber": "<string>",
        "barangay": "<string>",
        "buildingNameAndNumber": "<string>"
      },
      "middleName": "<string>"
    }
  ],
  "signatories": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "position": "<string>",
      "middleName": "<string>"
    }
  ],
  "websites": {
    "businessWebsiteUrl": "<string>",
    "isBusinessWebsiteUnderDevelopment": true,
    "facebookUrl": "<string>",
    "twitterUrl": "<string>",
    "instagramUrl": "<string>",
    "tiktokUrl": "<string>"
  },
  "aubPartnerId": "<string>",
  "estimatedMonthlyGrossTransaction": "<string>"
}
'

import requests

url = "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}"

payload = {
    "merchantName": "<string>",
    "modeOfPayments": [],
    "tin": "<string>",
    "industry": "<string>",
    "serviceDescription": "<string>",
    "isBrickAndMortarStore": True,
    "address": { "office": {
            "city": "<string>",
            "line1": "<string>",
            "state": "<string>",
            "postalCode": "<string>",
            "contactNumber": "<string>",
            "barangay": "<string>",
            "buildingNameAndNumber": "<string>"
        } },
    "representatives": {
        "authorized": {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "position": "<string>",
            "middleName": "<string>",
            "tin": "<string>",
            "sss": "<string>",
            "mothersMaidenName": "<string>"
        },
        "escalation": {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "tin": "<string>",
            "sss": "<string>",
            "position": "<string>"
        }
    },
    "banks": [
        {
            "bankName": "<string>",
            "accountName": "<string>",
            "accountNumber": "<string>"
        }
    ],
    "isWantPackworksWallet": True,
    "isWantPayMayaWallet": True,
    "isWantPayMayaBankAccount": True,
    "legalName": "<string>",
    "businessHandle": "<string>",
    "incorporators": [
        {
            "firstName": "<string>",
            "lastName": "<string>",
            "emailAddress": "jsmith@example.com",
            "contactNumber": "<string>",
            "dateOfBirth": "2023-12-25",
            "address": {
                "city": "<string>",
                "line1": "<string>",
                "state": "<string>",
                "postalCode": "<string>",
                "contactNumber": "<string>",
                "barangay": "<string>",
                "buildingNameAndNumber": "<string>"
            },
            "middleName": "<string>"
        }
    ],
    "signatories": [
        {
            "firstName": "<string>",
            "lastName": "<string>",
            "position": "<string>",
            "middleName": "<string>"
        }
    ],
    "websites": {
        "businessWebsiteUrl": "<string>",
        "isBusinessWebsiteUnderDevelopment": True,
        "facebookUrl": "<string>",
        "twitterUrl": "<string>",
        "instagramUrl": "<string>",
        "tiktokUrl": "<string>"
    },
    "aubPartnerId": "<string>",
    "estimatedMonthlyGrossTransaction": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    merchantName: '<string>',
    modeOfPayments: [],
    tin: '<string>',
    industry: '<string>',
    serviceDescription: '<string>',
    isBrickAndMortarStore: true,
    address: {
      office: {
        city: '<string>',
        line1: '<string>',
        state: '<string>',
        postalCode: '<string>',
        contactNumber: '<string>',
        barangay: '<string>',
        buildingNameAndNumber: '<string>'
      }
    },
    representatives: {
      authorized: {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        position: '<string>',
        middleName: '<string>',
        tin: '<string>',
        sss: '<string>',
        mothersMaidenName: '<string>'
      },
      escalation: {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        tin: '<string>',
        sss: '<string>',
        position: '<string>'
      }
    },
    banks: [{bankName: '<string>', accountName: '<string>', accountNumber: '<string>'}],
    isWantPackworksWallet: true,
    isWantPayMayaWallet: true,
    isWantPayMayaBankAccount: true,
    legalName: '<string>',
    businessHandle: '<string>',
    incorporators: [
      {
        firstName: '<string>',
        lastName: '<string>',
        emailAddress: 'jsmith@example.com',
        contactNumber: '<string>',
        dateOfBirth: '2023-12-25',
        address: {
          city: '<string>',
          line1: '<string>',
          state: '<string>',
          postalCode: '<string>',
          contactNumber: '<string>',
          barangay: '<string>',
          buildingNameAndNumber: '<string>'
        },
        middleName: '<string>'
      }
    ],
    signatories: [
      {
        firstName: '<string>',
        lastName: '<string>',
        position: '<string>',
        middleName: '<string>'
      }
    ],
    websites: {
      businessWebsiteUrl: '<string>',
      isBusinessWebsiteUnderDevelopment: true,
      facebookUrl: '<string>',
      twitterUrl: '<string>',
      instagramUrl: '<string>',
      tiktokUrl: '<string>'
    },
    aubPartnerId: '<string>',
    estimatedMonthlyGrossTransaction: '<string>'
  })
};

fetch('https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'merchantName' => '<string>',
    'modeOfPayments' => [
        
    ],
    'tin' => '<string>',
    'industry' => '<string>',
    'serviceDescription' => '<string>',
    'isBrickAndMortarStore' => true,
    'address' => [
        'office' => [
                'city' => '<string>',
                'line1' => '<string>',
                'state' => '<string>',
                'postalCode' => '<string>',
                'contactNumber' => '<string>',
                'barangay' => '<string>',
                'buildingNameAndNumber' => '<string>'
        ]
    ],
    'representatives' => [
        'authorized' => [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'position' => '<string>',
                'middleName' => '<string>',
                'tin' => '<string>',
                'sss' => '<string>',
                'mothersMaidenName' => '<string>'
        ],
        'escalation' => [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'tin' => '<string>',
                'sss' => '<string>',
                'position' => '<string>'
        ]
    ],
    'banks' => [
        [
                'bankName' => '<string>',
                'accountName' => '<string>',
                'accountNumber' => '<string>'
        ]
    ],
    'isWantPackworksWallet' => true,
    'isWantPayMayaWallet' => true,
    'isWantPayMayaBankAccount' => true,
    'legalName' => '<string>',
    'businessHandle' => '<string>',
    'incorporators' => [
        [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'emailAddress' => 'jsmith@example.com',
                'contactNumber' => '<string>',
                'dateOfBirth' => '2023-12-25',
                'address' => [
                                'city' => '<string>',
                                'line1' => '<string>',
                                'state' => '<string>',
                                'postalCode' => '<string>',
                                'contactNumber' => '<string>',
                                'barangay' => '<string>',
                                'buildingNameAndNumber' => '<string>'
                ],
                'middleName' => '<string>'
        ]
    ],
    'signatories' => [
        [
                'firstName' => '<string>',
                'lastName' => '<string>',
                'position' => '<string>',
                'middleName' => '<string>'
        ]
    ],
    'websites' => [
        'businessWebsiteUrl' => '<string>',
        'isBusinessWebsiteUnderDevelopment' => true,
        'facebookUrl' => '<string>',
        'twitterUrl' => '<string>',
        'instagramUrl' => '<string>',
        'tiktokUrl' => '<string>'
    ],
    'aubPartnerId' => '<string>',
    'estimatedMonthlyGrossTransaction' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}"

	payload := strings.NewReader("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}")
  .asString();

using RestSharp;


var options = new RestClientOptions("https://kyc.sbx.moduluslabs.io/v2/onboard/{refNo}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"merchantName\": \"<string>\",\n  \"modeOfPayments\": [],\n  \"tin\": \"<string>\",\n  \"industry\": \"<string>\",\n  \"serviceDescription\": \"<string>\",\n  \"isBrickAndMortarStore\": true,\n  \"address\": {\n    \"office\": {\n      \"city\": \"<string>\",\n      \"line1\": \"<string>\",\n      \"state\": \"<string>\",\n      \"postalCode\": \"<string>\",\n      \"contactNumber\": \"<string>\",\n      \"barangay\": \"<string>\",\n      \"buildingNameAndNumber\": \"<string>\"\n    }\n  },\n  \"representatives\": {\n    \"authorized\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"mothersMaidenName\": \"<string>\"\n    },\n    \"escalation\": {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"tin\": \"<string>\",\n      \"sss\": \"<string>\",\n      \"position\": \"<string>\"\n    }\n  },\n  \"banks\": [\n    {\n      \"bankName\": \"<string>\",\n      \"accountName\": \"<string>\",\n      \"accountNumber\": \"<string>\"\n    }\n  ],\n  \"isWantPackworksWallet\": true,\n  \"isWantPayMayaWallet\": true,\n  \"isWantPayMayaBankAccount\": true,\n  \"legalName\": \"<string>\",\n  \"businessHandle\": \"<string>\",\n  \"incorporators\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"emailAddress\": \"jsmith@example.com\",\n      \"contactNumber\": \"<string>\",\n      \"dateOfBirth\": \"2023-12-25\",\n      \"address\": {\n        \"city\": \"<string>\",\n        \"line1\": \"<string>\",\n        \"state\": \"<string>\",\n        \"postalCode\": \"<string>\",\n        \"contactNumber\": \"<string>\",\n        \"barangay\": \"<string>\",\n        \"buildingNameAndNumber\": \"<string>\"\n      },\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"signatories\": [\n    {\n      \"firstName\": \"<string>\",\n      \"lastName\": \"<string>\",\n      \"position\": \"<string>\",\n      \"middleName\": \"<string>\"\n    }\n  ],\n  \"websites\": {\n    \"businessWebsiteUrl\": \"<string>\",\n    \"isBusinessWebsiteUnderDevelopment\": true,\n    \"facebookUrl\": \"<string>\",\n    \"twitterUrl\": \"<string>\",\n    \"instagramUrl\": \"<string>\",\n    \"tiktokUrl\": \"<string>\"\n  },\n  \"aubPartnerId\": \"<string>\",\n  \"estimatedMonthlyGrossTransaction\": \"<string>\"\n}", false);
var response = await client.PutAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "onboardingStatus": "PENDING",
  "onboardingReferenceNumber": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "statusCode": 123,
  "message": "<string>",
  "error": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "message": "<string>",
  "error": "<string>",
  "details": {}
}

Overview

Updates the onboarding data for a merchant using the onboarding reference number. This endpoint allows merchants to correct and resubmit their information after their application has been declined.

Status Requirement: Regular users can only update merchants in DECLINED status. Upon successful update, the merchant’s status changes to PENDING for re-review.

Updates are accepted only for records in the DECLINED state, which then move to PENDING for re-review.

Authentication

This endpoint requires JWT Bearer Token authentication.

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Authorization Rules

User Role	Required Merchant Status	Result Status After Update
Regular User	DECLINED	PENDING

Transaction Behavior

Atomic update: Either all changes in a request are applied, or none are.

The update process includes:

Validating all request parameters
Checking user authorization and merchant status
Updating business information
Updating incorporators and signatories
Updating addresses and representatives
Updating bank accounts
Changing status to PENDING (for regular users)

If any step fails, no changes are persisted.

Validation Rules Summary

Business Type

Non-STARTER businesses require legalName and businessHandle

Bank Accounts

When not NO_ACCOUNT: bankName, accountName, accountNumber, currency required

Bank Type

When accountDepositType is BANK: accountType is also required

Website

If businessWebsiteUrl provided: isBusinessWebsiteUnderDevelopment required

Status Change Flow

Merchant is DECLINED

Admin has declined the merchant’s onboarding application with a reason

Merchant Updates Data

Merchant corrects the issues and submits update via this endpoint

Status Changes to PENDING

Upon successful update, status automatically changes to PENDING

Admin Re-reviews

Admin reviews the updated information and either approves or declines again

Use Cases

Fix Declined Application

Correct issues identified in decline reason and resubmit

Update Business Info

Update business details after changes

Add Missing Documents

Add information that was missing in original submission

Correct Validation Errors

Fix validation issues from initial onboarding

Troubleshooting

Cannot Update APPROVED Merchant

Error: Unable to update. Merchant is not in declined status.Issue: Regular users cannot update approved merchantsSolution:

Only DECLINED merchants can be updated by regular users
Approved records are updated only through Modulus review.
To update business details after approval, create a new onboarding request

Transaction Keeps Rolling Back

Issue: Update fails with Failed to update onboarding recordPossible Causes:

Database connectivity issues
Data integrity constraints violated
Concurrent updates from multiple sources

Solution:

Retry the request after a short delay
Ensure no concurrent updates are happening
Contact support if issue persists

Validation Errors on Update

Issue: Getting validation errors like merchantName is requiredSolution:

Ensure ALL required fields from original onboarding are included
Don’t just send changed fields - send complete data
Use retrieve endpoint to get current data first
Validate against the same rules as initial onboarding

Field Validation Reference

Text Fields
Enums
Patterns
Arrays

First/Middle/Last Names: 1-100 chars, Unicode letters, spaces, hyphens, apostrophes
Email: Valid email format, max 100 chars
TIN: Numbers only, max 20 chars
Postal Code: 4-10 digits, numbers only
Contact Number: Numbers only, max 30 chars
SSS: Exactly 10 digits

businessHandle: ^([A-Za-z]|[0-9]|_|-)+$
tin: ^\d+$
postalCode: ^\d+$
contactNumber: ^\d+$

Next Steps

Retrieve Onboarding Data

Get current onboarding data before updating

Retrieve Status

Check if merchant is in DECLINED status

Onboard Merchant

View original onboarding endpoint documentation

Error Handling

Complete error code reference

Authorizations

Authorization

string

header

required

JWT Bearer token authentication

Path Parameters

refNo

string<uuid>

required

The onboarding reference number (UUID v4 format)

Body

application/json

Resubmit a declined application. Unlike a partial patch, the service revalidates the full business profile: the fields below marked required must all be present. businessType and parentOnboardingRefNo are set on the initial submission (POST /v2/onboard) and cannot be changed here.

merchantName

string

required

Trading name or DBA (Doing Business As) name

Maximum string length: 500

modeOfPayments

enum<string>[]

required

List of accepted payment modes

Minimum array length: 1

Available options:

TERMINAL,

ECOM,

PAYMENT_LINK,

QRPH,

PAY_WITH_MAYA

currency

enum<string>

required

Primary currency for transactions

Available options:

PHP,

USD

tin

string

required

Tax Identification Number

Maximum string length: 20

Pattern: ^\d+$

industry

string

required

Business industry category

Maximum string length: 200

serviceDescription

string

required

Description of services or products offered

isBrickAndMortarStore

boolean

required

Whether the business has a physical store location

address

object

required

Show child attributes

representatives

object

required

Show child attributes

banks

object[]

required

List of bank accounts for settlement

Required array length: 1 - 2 elements

Show child attributes

isWantPackworksWallet

boolean

required

Whether the merchant wants a wallet.

isWantPayMayaWallet

boolean

required

Whether the merchant wants a Maya wallet.

isWantPayMayaBankAccount

boolean

required

Whether the merchant wants a Maya bank account.

legalName

string

Legal registered name of the business (required for non-STARTER types)

Maximum string length: 500

businessHandle

string

Unique business handle/slug for payment links (required for non-STARTER types)

Pattern: ^([A-Za-z]|[0-9]|_|-)+$

incorporators

object[]

List of business incorporators (for non-STARTER types)

Required array length: 1 - 5 elements

Show child attributes

signatories

object[]

List of authorized signatories

Required array length: 1 - 5 elements

Show child attributes

websites

object

Show child attributes

aubPartnerId

string

Optional partner identifier.

estimatedMonthlyGrossTransaction

string

Optional estimated monthly gross transaction volume.

Response

Onboarding data updated successfully

onboardingStatus

enum<string>

Always PENDING after a resubmission; the application returns to review.

Available options:

PENDING

onboardingReferenceNumber

string<uuid>

The onboarding reference number (unchanged)

QR API

Webhooks API

Onboarding API

Transaction Reporting API

Terminal Gateway API

Ecom API

Update Onboarding Data

Overview

Authentication

Authorization Rules

Transaction Behavior

Validation Rules Summary

Business Type

Bank Accounts

Bank Type

Website

Status Change Flow

Use Cases

Fix Declined Application

Update Business Info

Add Missing Documents

Correct Validation Errors

Troubleshooting

Field Validation Reference

Next Steps

Retrieve Onboarding Data

Retrieve Status

Onboard Merchant

Error Handling

Authorizations

Path Parameters

Body

Response