Introduction
9x Paynet OpenAPI — unified entry, dual auth, Access Key
9x Paynet OpenAPI is for merchants and integrators. There is one HTTP entry: everything is POST /api/entry, and method in the body selects the capability.
What you get
| Capability | Description |
|---|---|
| Unified entry | POST /api/entry, flat JSON; HTTP is usually 200 — check business code |
| App signature | Every request is signed with the app private key (RSA2, morph 1) |
| Access Key | Optional second gate (morph 2): key_id + HMAC key_sign |
| Payment methods | Place order, query, refund, etc. (selected by method) |
Methods in the current contract:
- Admin:
access.key.create/list/rotate/revoke - Payments:
pay.unifiedorder,order.query,order.refund.submit,order.refund.query
Suggested reading order
- Unified entry — request shape
- Authentication — RSA2 and Access Key HMAC
- Access Key — scopes and lifecycle
- Errors — envelope and E0731x / E025xx
- API Reference — fields and examples (from OpenAPI)
- Try with Apifox — import this repo’s collection
Environment
us-test base URL: https://api.9xnetwork.com
(Use the environment you were given; production hosts are issued separately.)