Object ID Prefixes

Preczn uses prefixes at the start of object IDs to help users identify object types quickly. These prefixes indicate the object's type making it easier for users to identify and interpret the represented objects.

Key Points

Legacy Support: The system maintains backward compatibility—all existing IDs such as tokens, transactions, etc that do not have a prefix are still supported via the Preczn APIs and Interfaces.

Implementation Timeline: The prefix system applies to IDs created around July 2023 onward.

Prefix Reference Table

Object	Test Prefix	Live Prefix
API Key - Public	`pub_test_`	`pub_`
API Key - Private	`priv_test_`	`priv_`
Bank Account (Merchant)	`midBank_test_`	`midBank_`
Boarding Domain	`brd_test_`	`brd_`
Boarding Form	`form_test_`	`form_`
Boarding Form Template	`formTemp_test_`	`formTemp_`
Contact	`cnt_test_`	`cnt_`
Loan	`loan_test_`	`loan_`
Merchant Attachment	`midDoc_test_`	`midDoc_`
Merchant Connection	`midCon_test_`	`midCon_`
Merchant	`mid_test_`	`mid_`
Merchant Import Record	`midImp_test_`	`midImp_`
Merchant Location	`midLoc_test_`	`midLoc_`
Owner (Merchant)	`midOwn_test_`	`midOwn_`
Payment Token	`tkn_test_`	`tkn_`
Platform	Live only	`pfm_`
Platform Connection	`pfmCon_test_`	`pfmCon_`
Platform Domain	`dmn_test_`	`dmn_`
Plan	`plan_test_`	`plan_`
Portfolio	Live only	`port_`
Preczn User	Live only	`user_`
Requirements Template	`reqTemp_test_`	`reqTemp_`
SAQ	`saq_test_`	`saq_`
Transaction	`txn_test_`	`txn_`
Webhook Subscription	`wh_test_`	`wh_`
Webhook Attempt	`what_test_`	`what_`

ℹ️ Objects marked "Live only"

Platforms, portfolios, and Preczn users exist once per account rather than per mode, so their IDs use a single live prefix with no test-mode equivalent.