Get payments for a merchant

Retrieve payments for a merchant.

Authentication

Requires X-Access-Key and X-Secret-Key headers.

Path parameters

• merchantId (string): the merchant identifier

Query parameters

Supports paging/filtering:

• page (number, min 1, default 1)
• limit (number, min 10, max 100, default 10)
• search (string): optional free-text search
• sortOrder (string, enum: ASC | DESC, default DESC)
• sortBy (string, enum: createdAt | amount | status, default createdAt)
• status (string, enum: created | processing | completed | failed | expired | refunded)
• paymentMethod (string, enum: card | crypto | bank_transfer)
• currency (string): example EUR

Response

• 200: Merchant payments retrieved successfully.
• 400: Bad request
• 401: Unauthorized
• 403: Forbidden
• 500: Internal server error