Enums Reference

Overview

This page lists all valid enumeration values accepted by the Onboarding API. Use these exact string values when submitting merchant onboarding requests.

All enum values are case-sensitive. Make sure to use the exact capitalization shown below.

Business Type

Determines the type of business entity and affects which fields are required during onboarding.

Value	Description	Incorporators Required	Legal Name Required
`STARTER`	Starter Business	No	No
`SOLE_PROPRIETOR`	Sole Proprietor	1	Yes
`PARTNERSHIP`	Partnership	2	Yes
`CORPORATION`	Corporation	Minimum 3	Yes

Usage Example

{
  "businessType": "STARTER"
}

STARTER

Best for: Small businesses, sole traders, freelancersRequirements:

Barangay Business Permit
No incorporators needed
No registered address needed
Legal name optional

Settlement accounts: Must provide at least one bank account

SOLE_PROPRIETOR

Best for: Individual business ownersRequirements:

1 incorporator required
Legal name required
Registered address required
Additional KYC documents

Validation: System checks that exactly 1 incorporator is provided

PARTNERSHIP

Best for: Business partnerships, joint venturesRequirements:

2 incorporators required
Legal name required
Registered address required
Partnership agreement documents

Validation: System checks that exactly 2 incorporators are provided

CORPORATION

Best for: Registered corporationsRequirements:

Minimum 3 incorporators required
Legal name required
Registered address required
Corporate registration documents

Validation: System checks that at least 3 incorporators are provided

Mode of Payment

Specifies which payment channels the merchant wants to enable.

Value	Description	Use Case
`TERMINAL`	Physical POS terminals	In-store retail
`ECOM`	E-commerce integration	Online checkout
`PAYMENT_LINK`	Shareable payment URLs	Invoices, remote sales
`QRPH`	QR Ph standard	Contactless payments
`PAY_WITH_MAYA`	Maya wallet	E-wallet transactions

Usage Example

{
  "modeOfPayments": ["ECOM", "QRPH", "PAYMENT_LINK"]
}

Merchants can enable multiple payment methods. Provide an array of values based on the merchant’s needs.

Currency

Three-letter ISO 4217 currency codes for customer transactions.

Value	Description
`PHP`	Philippine Peso
`USD`	United States Dollar

Usage Example

{
  "currency": "PHP"
}

Currently, only PHP and USD are supported. The default currency is PHP.

Bank Names

All supported banks for settlement accounts. Use these exact values for the bankName field.

Major Banks (A-M)
Major Banks (P-Z)
E-Wallets

Value	Bank Name
`AGRIBUSINESS_RURAL_BANK_INC`	Agribusiness Rural Bank
`AL_AMANAH_ISLAMIC_BANK`	Al Amanah Islamic Bank
`ALIPAY_PHILIPPINES_INC`	Alipay Philippines
`ALLBANK_INC`	AllBank
`ANZ_BANK`	ANZ Bank
`ASIA_UNITED_BANK`	Asia United Bank
`BANANAPAY_FINTECH_SERVICES_CORPORATION`	Bananapay
`BANGKO_KABAYAN`	Bangko Kabayan
`BANGKO_MABUHAY_A_RURAL_BANK_INC`	Bangko Mabuhay
`BANGKO_NUESTRA_SENORA_DEL_PILAR`	Bangko Nuestra Senora del Pilar
`BANGKOK_BANK`	Bangkok Bank
`BANK_OF_AMERICA_NA`	Bank of America
`BANK_OF_CHINA_MANILA`	Bank of China
`BANK_OF_COMMERCE`	Bank of Commerce
`BANK_OF_FLORIDA`	Bank of Florida
`BANK_OF_MAKATI`	Bank of Makati
`BANK_OF_THE_PHILIPPINE_ISLANDS_BPI`	BPI
`BAYANIHAN_BANK_INC_ATIMONAN`	Bayanihan Bank
`BDO_NETWORK_BANK`	BDO Network Bank
`BDO_UNIBANK`	BDO Unibank
`BINAN_RURAL_BANK_INC`	Binan Rural Bank
`BPI_DIRECT_BANKO_INC_A_SAVINGS_BANK`	BPI Direct Banko
`CAMALIG_BANK_INC_A_RURAL_BANK`	Camalig Bank
`CANTILAN_BANK_INC`	Cantilan Bank
`CARD_BANK_INC`	Card Bank
`CARD_MRI_RIZAL_BANK_INC`	Card MRI Rizal Bank
`CARD_SME_BANK_INC_A_THRIFT_BANK`	Card SME Bank
`CATHAY_UNITED_BANK_CO_LTD`	Cathay United Bank
`CEBUANA_LHUILLIER_RURAL_BANK_INC`	Cebuana Lhuillier Rural Bank
`CHINA_BANK`	China Banking Corporation
`CHINA_BANK_SAVINGS`	China Bank Savings
`CIMB`	CIMB Bank Philippines
`CIS_BAYAD_CENTER_INC_CBCI`	CIS Bayad Center
`CITIBANK_NA`	Citibank
`CITY_SAVINGS_BANK`	City Savings Bank
`COOPERATIVE_BANK_OF_QUEZON_PROVINCE`	Cooperative Bank of Quezon Province
`COUNTRY_BUILDERS_BANKING`	Country Builders Bank
`CTBC_BANK`	CTBC Bank
`DCPAY_PHILIPPINES_INC_COINSPH`	DCPay Philippines
`DEUTSCHE_BANK`	Deutsche Bank
`DEVELOPMENT_BANK_OF_THE_PHILIPPINES_DBP`	Development Bank of the Philippines
`DM_BANK`	DM Bank
`DUMAGUETE_CITY_DEVELOPMENT_BANK_INC`	Dumaguete City Development Bank
`DUNGGANUN_BANK`	Dungganun Bank
`EAST_WEST_RURAL_BANK_INC`	East West Rural Bank
`EASTWEST_BANK`	EastWest Bank
`EASY_PAY_GLOBAL_EMI_CORP`	Easy Pay Global
`ENTREPRENEUR_RURAL_BANK_INC`	Entrepreneur Rural Bank
`EQUICOM_SAVINGS_BANK`	Equicom Savings Bank
`FIRST_CONSOLIDATED_BANK`	First Consolidated Bank
`GCASH`	G-Xchange
`GM_BANK_OF_LUZON_INC`	GM Bank of Luzon
`GOTYME`	GoTyme Bank
`GRABPAY`	GrabPay
`GUAGUA_RURAL_BANK_INC`	Guagua Rural Bank
`HONG_KONG_AND_SHANGHAI_BANK_HSBC`	HSBC
`HSBC_SAVINGS_BANK_PHILSINC`	HSBC Savings Bank
`INDUSTRIAL_BANK_OF_KOREA_MANILA`	Industrial Bank of Korea
`INDUSTRIAL_COMMERCIAL_BANK_OF_CHINA`	ICBC
`INFOSERVE_INCORPORATED_NATIONLINK`	Infoserve
`ING_BANK`	ING Bank
`INNOVATIVE_BANK`	Innovative Bank
`I-REMIT_INC`	I-Remit
`ISLA_BANK_A_THRIFT_BANK_INC`	ISLA Bank
`JP_MORGAN_CHASE_BANK_MANILA`	JP Morgan Chase Bank
`KOREA_EXCHANGE_BANK`	KEB Hana Bank
`LAGUNA_PRESTIGE_BANKING_CORPORATION`	Laguna Prestige Banking Corp
`LAND_BANK_OF_THE_PHILIPPINES`	Land Bank of the Philippines
`LEGAZPI_SAVINGS_BANK_INC`	Legazpi Savings Bank
`LOLC_BANK_PHILIPPINES_INC`	LOLC Bank
`LULU_FINANCIAL_SERVICES_PHILS_INC`	Lulu Financial Services
`LUZON_DEVELOPMENT_BANK`	Luzon Development Bank
`MALARAYAT_RURAL_BANK_INC`	Malarayat Rural Bank
`MALAYAN_BANK_SAVINGS_AND_MORTGAGE_BANK_INC`	Malayan Bank
`MARCOPAY_INC`	Marcopay
`MAYA_BANK`	Maya Bank
`MAYBANK_PHILIPPINES`	Maybank Philippines
`MEGA_INTERNATIONAL_COMMERCIAL_BANK`	ICBC
`METROPOLITAN_BANK_TRUST_CO_METROBANK`	Metrobank
`MINDANAO_CONSOLIDATED_COOPERATIVE_BANK`	Mindanao Consolidated Coop Bank
`MIZUHO_BANK`	Mizuho Bank
`MONEY_MALL_RURAL_BANK_INC`	Money Mall Rural Bank
`MUFG_BANK`	MUFG Bank
`MVSM_BANK_A_RURAL_BANK_INC`	MVSM Bank
`NETBANK_A_RURAL_BANK_INC`	Netbank
`NEW_RURAL_BANK_OF_SAN_LEONARDO_NUEVA_ECIJA_INC`	New Rural Bank of San Leonardo
`OMNIPAY_INC`	Omnipay
`OWN_BANK_THE_RURAL_BANK_OF_CAVITE_CITY_INC`	Own Bank

Value	Bank Name
`PACIFIC_ACE_SAVINGS_BANK_INC`	Pacific Ace Savings Bank
`PALAWANPAY`	PalawanPay
`PARTNER_RURAL_BANK_COTABATO_INC`	Partner Rural Bank
`PAYMAYA`	Maya Philippines
`PAYMONGO_PAYMENTS_INC`	PayMongo
`PAYNAMICS_TECHNOLOGIES_INC`	Paynamics
`PEPPERMINT_BIZMOTO_INC`	Peppermint Bizmoto
`PHILIPPINE_BANK_OF_COMMUNICATIONS_PBCOM`	Philippine Bank of Communications
`PHILIPPINE_BUSINESS_BANK_INC_A_SAVINGS_BANK`	Philippine Business Bank
`PHILIPPINE_DIGITAL_ASSET_EXCHANGE_INC`	Philippine Digital Asset Exchange
`PHILIPPINE_NATIONAL_BANK_PNB`	Philippine National Bank
`PHILIPPINE_SAVINGS_BANK_PSBANK`	Philippine Savings Bank
`PHILIPPINE_VETERANS_BANK`	Philippine Veterans Bank
`PHILTRUST_BANK`	Philippine Trust Company
`PORAC_BANK_A_RURAL_BANK`	Porac Bank
`PRODUCERS_SAVINGS_BANK_CORPORATION`	Producers Savings Bank
`QUEEN_CITY_DEVELOPMENT_BANK_INC`	Queen City Development Bank
`QUEZON_CAPITAL_RURAL_BANK_INC`	Quezon Capital Rural Bank
`RANG-AY_BANK_A_RURAL_BANK_INC`	Rang-ay Bank
`RBT_BANK_INC_A_RURAL_BANK`	RBT Bank
`RIZAL_COMMERCIAL_BANKING_CORP_RCBC`	RCBC
`ROBINSONS_BANK`	Robinsons Bank
`RURAL_BANK_OF_BACOLOD_CITY_INC`	Rural Bank of Bacolod City
`RURAL_BANK_OF_BAUANG_INC`	Rural Bank of Bauang
`RURAL_BANK_OF_DIGOS_INC`	Rural Bank of Digos
`RURAL_BANK_OF_GUINOBATAN_INC`	Rural Bank of Guinobatan
`RURAL_BANK_OF_LA_PAZ_INC`	Rural Bank of La Paz
`RURAL_BANK_OF_LEBAK_SULTAN_KUDARAT_INC`	Rural Bank of Lebak
`RURAL_BANK_OF_MANGALDAN_INC`	Rural Bank of Mangaldan
`RURAL_BANK_OF_MONTALBAN_INC`	Rural Bank of Montalban
`RURAL_BANK_OF_ROSARIO_LU_INC`	Rural Bank of Rosario
`RURAL_BANK_OF_SAGAY_INC`	Rural Bank of Sagay
`RURAL_BANK_OF_SAN_MEDJUGORJE`	Rural Bank of San Medjugorje
`RURAL_BANK_OF_SAN_NARCISO_INC`	Rural Bank of San Narciso
`RURAL_BANK_OF_SILAY_CITY_INC`	Rural Bank of Silay City
`RURAL_BANK_OF_STA_IGNACIA_INC`	Rural Bank of Sta. Ignacia
`RURALBANK_OF_ANGELES`	Ruralbank of Angeles
`SEABANK`	SEABANK
`SECURITY_BANK`	Security Bank
`SHINHAN_BANK`	Shinhan Bank
`SHOPEEPAY_PHILIPPINES_INC`	ShopeePay Philippines
`SOUTHEAST_COUNTRY_BANK_INC`	Southeast Country Bank
`SPEEDYPAY_INC`	SpeedyPay
`STANDARD_CHARTERED_BANK`	Standard Chartered Bank
`STARPAY_CORPORATION`	Starpay Corporation
`STERLING_BANK_OF_ASIA`	Sterling Bank of Asia
`SUMIMOTO_MITSUI_BANKING_CORP`	Sumimoto Mitsui Banking Corp
`SUMMIT_BANK_RURAL_BANK_OF_TUBLAY_INC`	Summit Bank
`SUN_SAVINGS_BANK_INC`	Sun Savings Bank
`TAGCASH_LTD_INC`	TagCash
`TAYOCASH_INC`	TayoCash
`TOKTOKWALLET_INC`	TokTok Wallet
`TONG_YANG_SAVINGS_BANK`	Tong Yang Savings Bank
`TONIK_DIGITAL_BANK_INC`	Tonik Digital Bank
`TRAXION_PAY_INC`	Traxion Pay
`UCPB_SAVINGS_BANK_INC`	UCPB Savings Bank
`UNION_BANK_OF_THE_PHILIPPINES`	Union Bank of the Philippines
`UNIONDIGITAL_BANK_INC`	UnionDigital Bank
`UNITED_COCONUT_PLANTERS_BANK_UCPB`	United Coconut Planters Bank
`UNITED_OVERSEAS_BANK_UOB`	United Overseas Bank
`UNOBANK_INC`	UNOBank
`VIGAN_BANCO_RURAL_INCORPORADA`	Vigan Banco Rural
`WEALTH_DEVELOPMENT_BANK`	Wealth Development Bank
`WISE_PILIPINAS_INC`	Wise Pilipinas
`YUANTA_SAVINGS_BANK_INC`	Yuanta Savings Bank
`ZAMBALES_RURAL_BANK_INC`	Zambales Rural Bank
`ZYBI_TECH_INC_JUANCASH`	Zybi Tech / JuanCash

Value	Description
`GCASH`	GCash E-wallet
`PAYMAYA`	PayMaya E-wallet

Important: Only use GCASH when accountDepositType is "GCASH", and PAYMAYA when accountDepositType is "PAYMAYA".

Usage Example

{
  "banks": [
    {
      "accountDepositType": "BANK",
      "bankName": "BDO_UNIBANK",
      "accountType": "SAVINGS",
      "accountName": "Business Corporation",
      "accountNumber": "1234567890",
      "currency": "PHP"
    }
  ]
}

Bank Account Type

Account type for traditional bank accounts.

Value	Description
`SAVINGS`	Savings Account
`CHECKING_CURRENT`	Checking/Current Account

Usage Example

{
  "accountType": "SAVINGS"
}

This field is required only when accountDepositType is "BANK".

Bank Account Deposit Type

Specifies the type of settlement account.

Value	Description	When to Use
`BANK`	Traditional bank account	For standard bank settlements
`GCASH`	GCash e-wallet	For GCash settlements
`PAYMAYA`	PayMaya e-wallet	For PayMaya settlements
`NO_ACCOUNT`	No settlement account	Special cases only

Usage Examples

{
  "accountDepositType": "BANK",
  "accountType": "SAVINGS",
  "bankName": "BDO_UNIBANK",
  "accountName": "Business Corp",
  "accountNumber": "1234567890",
  "currency": "PHP"
}

{
  "accountDepositType": "GCASH",
  "bankName": "GCASH",
  "accountName": "Juan Dela Cruz",
  "accountNumber": "09123456789"
}

{
  "accountDepositType": "PAYMAYA",
  "bankName": "PAYMAYA",
  "accountName": "Maria Santos",
  "accountNumber": "09987654321"
}

BANK - Traditional Bank Account

Required fields:

accountType (SAVINGS or CHECKING_CURRENT)
bankName (from supported banks list)
accountName
accountNumber
currency

Use for: Standard bank transfers and settlements

GCASH - E-wallet

Required fields:

bankName (must be “GCASH”)
accountName
accountNumber (GCash mobile number)

Use for: GCash wallet settlements

The account number should be the GCash mobile number (e.g., “09123456789”)

PAYMAYA - E-wallet

Required fields:

bankName (must be “PAYMAYA”)
accountName
accountNumber (PayMaya mobile number)

Use for: PayMaya wallet settlements

NO_ACCOUNT

Use for: Special cases where no settlement account is needed

Contact Modulus Labs before using NO_ACCOUNT to confirm it’s appropriate for your use case.

Source of Funds

Indicates the source of funds for incorporators.

Value	Description
`EMPLOYMENT_INCOME`	Employment Income
`BUSINESS_INCOME`	Business Income
`SAVINGS_PERSONAL_FUNDS`	Savings/Personal Funds
`INVESTMENT_INCOME`	Investment Income
`INHERITANCE_OR_GIFTS`	Inheritance or Gifts
`LOAN_PROCEEDS`	Loan Proceeds
`OTHERS`	Others

Usage Example

{
  "incorporators": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "sourceOfFunds": "BUSINESS_INCOME",
      ...
    }
  ]
}

Gender

Gender options for incorporators and representatives.

Value	Description
`MALE`	Male gender
`FEMALE`	Female gender

Usage Example

{
  "gender": "MALE"
}

Onboarding Status

Lifecycle states for merchant onboarding applications.

Value	Description	Next Possible States
`NEW`	Initial submission, awaiting approval	APPROVED, DECLINED
`APPROVED`	Merchant approved	DECLINED (if issues found)
`DECLINED`	Merchant declined	PENDING (after update)
`PENDING`	Resubmitted after decline, awaiting re-approval	APPROVED, DECLINED

Status Flow

NEW

When: Initial merchant onboarding submissionMerchant Action: Wait for Modulus Labs reviewNext Steps: Status will change to either APPROVED or DECLINED

APPROVED

When: Merchant passes KYC verificationMerchant Action: Can start accepting paymentsNote: Approved merchants can be declined later if compliance issues are discovered

DECLINED

When: Merchant fails KYC verification or documents are incompleteMerchant Action: Review decline reason, update information, and resubmitNext Steps: Resubmitting will change status to PENDING

PENDING

When: Merchant has updated information after being declinedMerchant Action: Wait for re-review by Modulus LabsNext Steps: Status will change to either APPROVED or DECLINED

Validation Quick Reference

Use this table for quick validation during implementation:

Field	Type	Format	Notes
`businessType`	Enum	String	Use exact enum value
`legalName`	String	1-500 chars	Required for non-STARTER
`merchantName`	String	1-500 chars	Always required
`tin`	String	9-12 digits	Numbers only
`currency`	Enum	3 chars	Usually “PHP”
`industry`	String	1-200 chars	Brief description
`contactNumber`	String	1-30 digits	Numbers only
`postalCode`	String	4-10 digits	Numbers only
`emailAddress`	String	1-100 chars	Valid email format
`dateOfBirth`	String	ISO 8601	YYYY-MM-DDTHH:mm:ss.sssZ

Common Mistakes

Avoid these common enum-related errors:

Wrong Capitalization

Wrong: "businessType": "starter" or "GCASH" as bankName for bank typeCorrect: "businessType": "STARTER" and proper account deposit typeSolution: Always use uppercase for enum values

Invalid Bank for Deposit Type

Wrong:

{
  "accountDepositType": "BANK",
  "bankName": "GCASH"
}

Correct:

{
  "accountDepositType": "GCASH",
  "bankName": "GCASH"
}

Solution: Match bankName with accountDepositType

Missing Required Fields for Business Type

Wrong: CORPORATION with only 1 incorporatorCorrect: CORPORATION with at least 3 incorporatorsSolution: Check business type requirements in the table above

Invalid Enum Value

Wrong: "modeOfPayments": ["E-COMMERCE"]Correct: "modeOfPayments": ["ECOM"]Solution: Use exact enum values from this documentation

Next Steps

Onboard Merchant API

Use these enums in your onboarding requests

Authentication

Set up JWT authentication

Introduction

Back to Onboarding API overview

Error Handling

Handle validation errors

QR API

Onboarding API

Terminal Gateway

Transaction Reporting API

Ecom API

Shared Resources

Overview

Business Type

Usage Example

Mode of Payment

Usage Example

Currency

Usage Example

Bank Names

Usage Example

Bank Account Type

Usage Example

Bank Account Deposit Type

Usage Examples

Source of Funds

Usage Example

Gender

Usage Example

Onboarding Status

Status Flow

Validation Quick Reference

Common Mistakes

Next Steps

Onboard Merchant API

Authentication

Introduction

Error Handling

​Overview

​Business Type

​Usage Example

​Mode of Payment

​Usage Example

​Currency

​Usage Example

​Bank Names

​Usage Example

​Bank Account Type

​Usage Example

​Bank Account Deposit Type

​Usage Examples

​Source of Funds

​Usage Example

​Gender

​Usage Example

​Onboarding Status

​Status Flow

​Validation Quick Reference

​Common Mistakes

​Next Steps

Onboard Merchant API

Authentication

Introduction

Error Handling

Overview

Business Type

Usage Example

Mode of Payment

Usage Example

Currency

Usage Example

Bank Names

Usage Example

Bank Account Type

Usage Example

Bank Account Deposit Type

Usage Examples

Source of Funds

Usage Example

Gender

Usage Example

Onboarding Status

Status Flow

Validation Quick Reference

Common Mistakes

Next Steps