Skip to main content
Partner Business KYB is how you submit the legal identity of a business to Holdstation Pay for verification — the registered company details, its legal representative and directors, and the supporting documents for each. A KYB record covers either your own partner entity or a merchant operating under you, selected with subject_type.
KYB endpoints use the same Ed25519 signed-API scheme as the MID and KYC endpoints. See Request Signing.

​
Subject Type

For subject_type = 1, a partner holds at most one KYB record and reference_id is not used. For subject_type = 2, the same rule applies per reference_id — your own id for that merchant. Send your merchant id as reference_id, or omit it and Holdstation Pay generates one and returns it. A partner can therefore hold one live record per merchant beneath it.

​
One Live Record Per Subject

The record id is generated by Holdstation Pay and returned as id on submission — never send one yourself. There is no update endpoint.
  • While a record is Pending or Approved, another POST for the same subject fails with 409 Conflict.
  • Once a record is Rejected, POST again to replace it. The new submission resets the status to Pending, the record keeps its original id, and the files attached to the rejected submission are deleted.
Use List KYB with reference_id to check whether a merchant has already been filed and to recover its id.

​
Status Lifecycle

rejection_reason is set when the status is 3 and is an empty string otherwise.

​
Endpoints

There is no update endpoint and no delete endpoint. To change a record, wait for it to be rejected and submit again.

​
Next Steps

Field Reference

Every business, person, document, and file field.

Submission Rules

The checks a submission must pass before it is accepted.

Submitting Documents

File encoding, limits, and error codes.