Paycose Docs
Invoice
POST/invoices/{invoice_id}/mark_paid

Mark Paid Invoice

Mark an open invoice as paid without mounting a payment intent. Set paid_out_of_band: true when payment was collected outside this system (cash, bank transfer, a standalone charge) — mirrors Stripe's "Mark as paid (out of band)". Allowed from draft/open/past_due; idempotent when already paid.

Request

Example

curl -X POST 'https://api.paycose.com/api/v1/app1/platform/wallet/invoices/{{invoice_id}}/mark_paid' \
  -H 'X-Session-Token: {{session_token}}' \
  -H 'X-Country: {{country}}' \
  -d '{
  "paid_out_of_band": true
}'

Headers

NameValue
X-Session-Token{{session_token}}
X-Country{{country}}

Body

NameTypeValue
paid_out_of_bandbooleantrue
{
  "paid_out_of_band": true
}

Responses

200200 OK

Headers

NameValue
Content-Typeapplication/json

Body

{
  "id": "<string>",
  "object": "<string>",
  "resource": "<string>",
  "created_at": "<RFC3339 timestamp>",
  "errors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "next_action": [
    {
      "type": "<string>",
      "title": "<string>",
      "description": "<string>",
      "i18n_key": "<string>",
      "url": "<string>",
      "client_secret": "<string>",
      "payment_method": "<string>",
      "qr_data": "<string>"
    }
  ]
}
500500 Internal Server Error

Headers

NameValue
Content-Typeapplication/json

Body

{
  "object": "error",
  "code": "<string>",
  "key": "<string>",
  "i18n_key": "<string>",
  "message": "<string>",
  "request_id": "<string>"
}

On this page