iPintiPint Docs
Aggregator / PSP

Submit KYC Documents

Get an AWS S3 presigned URL to upload merchant KYC documents.

GET /merchant/account

GET/merchant/account

Get a new AWS S3 presigned URL for each KYC document you need to upload. Call this endpoint once per document.

Headers

HeaderRequiredDescription
content-typeYesapplication/json
apikeyYesYour API key
signatureYesHMAC-SHA384 signature
nonceYesCurrent Unix timestamp

Request

ParameterTypeRequiredDescription
idstringYesMerchant ID (from onboarding response)
keystringYesDocument 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/..." }
FieldTypeDescription
presigned_urlstringAWS 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:

  1. Proof of Business Entity — Company's registration document (Certificate of Incorporation or business license)
  2. Proof of Business Address — Current utility bill or business lease/rental agreement
  3. Photo ID of Beneficial Owner — Passport or National ID
  4. Bank Statement — 3 months bank statements
  5. 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

On this page