SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-09
Browse: SET Merchant API

SET Merchant API · Invoices

Match a payment by hand

POST/v1/payments/{id}/match

Key scope: write

Matches an unmatched payment to an open invoice paid to the same address or account. Raises payment.matched and moves the invoice. Card payments are matched only through their payment link.

Path parameters

id stringrequired
The payment's id.

Body

invoice stringrequired
An open or short invoice (inv_…).

Errors

  • 404 payment_unknown
  • 404 invoice_unknown
  • 409 payment_matched
  • 409 payment_card
  • 409 invoice_settled
  • 409 invoice_elsewhere
  • 409 amount_unknown
  • 403 invoices_merchant_only
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.