Aggregator / PSP
Submit KYC Documents
Get an AWS S3 presigned URL to upload merchant KYC documents.
GET /merchant/account
GET
/merchant/accountGet a new AWS S3 presigned URL for each KYC document you need to upload. Call this endpoint once per document.
Headers
| Header | Required | Description |
|---|---|---|
content-type | Yes | application/json |
apikey | Yes | Your API key |
signature | Yes | HMAC-SHA384 signature |
nonce | Yes | Current Unix timestamp |
Request
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Merchant ID (from onboarding response) |
key | string | Yes | Document filename (e.g. Proof of Business Entity) |
Example
curl --location --request GET \
'https://api.ipint.io:8003/merchant/account?id=MERCHANT_ID&key=Proof%20of%20Business%20Entity' \
--header 'content-type: application/json' \
--header 'apikey: your-api-key' \
--header 'signature: hmac-signature' \
--header 'nonce: current-unix-time'Success response (200)
{ "presigned_url": "https://s3.amazonaws.com/..." }| Field | Type | Description |
|---|---|---|
presigned_url | string | AWS S3 presigned URL — upload a single document to this URL |
Error response (400)
{ "error": true, "message": "description for error" }Required documents
Call this endpoint once per document with a different key for each:
- Proof of Business Entity — Company's registration document (Certificate of Incorporation or business license)
- Proof of Business Address — Current utility bill or business lease/rental agreement
- Photo ID of Beneficial Owner — Passport or National ID
- Bank Statement — 3 months bank statements
- Tax ID documents — EIN Verification, IRS letter, W9 form, or tax return (for US, Netherlands & German merchants)
Get a new presigned URL for each document. Each URL is for a single upload.
Next steps
- Settlement Info — configure merchant wallet
- Onboard a Merchant — the previous step
- Aggregator Overview — full PSP flow