POST /confirm

POST/confirm

Mark an invoice as paid. This is optional — used in custom checkout flows where the customer clicks "Paid & Confirm" on your page.

Request body

Parameter	Type	Required	Description
`marked_as_paid`	boolean	Yes	Set to `true` to mark as paid
`invoice_id`	string	Yes	The invoice ID to confirm
`email_address`	string	No	Customer's email address (for receipt)

Example request

{
  "marked_as_paid": true,
  "invoice_id": "3hovNh96SmZXXaQ7PwEHc5Rr2B4E",
  "email_address": "user@email.com"
}

curl example

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{
  "marked_as_paid": true,
  "invoice_id": "3hovNh96SmZXXaQ7PwEHc5Rr2B4E",
  "email_address": "user@email.com"
}' 'https://api.ipint.io:8003/confirm'

Response (200)

{
  "message": "OK",
  "merchant_website_redirect_url": "https://merchant.redirect"
}

Field	Type	Description
`message`	string	`OK` on success
`merchant_website_redirect_url`	string	The redirect URL to send the customer to

Calling /confirm does not mark the payment as successful — it signals that the customer has initiated payment. The actual status (COMPLETED, FAILED, etc.) is determined by blockchain confirmations and retrieved via GET /invoice.

Try it live

Open in Swagger UI →

Next steps

GET /invoice — check the actual payment status
POST /checkout — create a checkout session