vellTRDocs

Send Invoice

POST/v1/invoices/{id}/sendOptional

Move a draft to sent and email the buyer the public link. Requires buyerEmail.

Authentication

Signature Pattern

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/invoices/{id}/send\n{sha256(body)}")
HeaderValueDescription
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

Request Example

JSONRequest Body
{}

Response Parameters

FieldTypeExample
idstring"inv_7a8b9c0d1e2f"
statusstring"sent"
sentAtstring"2026-04-13T10:05:00Z"

Response Example

JSONResponse
{
  "id": "inv_7a8b9c0d1e2f",
  "status": "sent",
  "sentAt": "2026-04-13T10:05:00Z"
}

Status Codes

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMock
POSThttps://api.pay.sandbox.kvell.group