Skip to main content
POST
/
invoices
/
create
curl --request POST \
  --url https://app.lt.cryptoprocessing.com/api/v2/invoices/create \
  --header 'Content-Type: application/json' \
  --header 'X-Processing-Key: <api-key>' \
  --header 'X-Processing-Signature: <x-processing-signature>' \
  --data '
{
  "timer": false,
  "title": "Invoice Title",
  "currency": "EUR",
  "amount": 100,
  "foreign_id": "invoice_123",
  "end_user_reference": "user_12345",
  "url_success": "https://example.com/success",
  "url_failed": "https://example.com/failed",
  "email_user": "[email protected]",
  "sender_type": "natural",
  "sender_data": {
    "first_name": "Friedrich",
    "last_name": "Müller",
    "date_of_birth": "1995-08-17"
  }
}
'
{
  "data": {
    "id": 826900,
    "url": "https://invoices.sandbox.cryptoprocessing.com/invoice/Jyf1cQ",
    "foreign_id": "invoice_123",
    "end_user_reference": "user_12345",
    "address": null,
    "title": "Invoice Title",
    "status": "created",
    "currency": "EUR",
    "amount": "100.00000000",
    "sender_currency": null,
    "sender_amount": null,
    "fixed_at": null,
    "release_at": null,
    "seconds_left": null
  }
}
CryptoProcessing is required to collect sender data in compliance with the MiCA regulations. For more details, see User data collection. The sender_data and the end_user_reference you provide must be associated with the same customer.

Authorizations

​
X-Processing-Key
string
header
required

Your API key.

Headers

​
X-Processing-Signature
string
required

Hex-encoded HMAC-SHA512 signature of the request body, generated using your secret key.

Body

application/json
​
end_user_reference
string
required

Permanent ID of the customer in your system. Used to group, track, and analyze transactions made by a specific customer. Must not contain personal data, such as the user's name or email address.

​
timer
boolean
required

If this parameter is set to true, the invoice will expire in 15 minutes after it is created.

​
title
string
required

Invoice title that the customer will see.

Required string length: 1 - 50
​
foreign_id
string
required

This invoice's unique ID in your system.

​
currency
string
required

Currency you want to receive deposits in. For a list of all available currencies, see API currency codes.

​
amount
number
required

Invoice amount that you want to receive from the customer.

​
url_success
string<uri>
required

The URL the customer will be redirected to in case of a successful invoice payment.

​
url_failed
string<uri>
required

The URL the customer will be redirected to in case of an unsuccessful invoice payment.

​
email_user
string<email>
required

If the amount the customer pays does not match the amount you set for the invoice, Cryptoprocessing will send an email to this address instructing the customer on how they can receive a refund. If they paid less, they will receive a full refund. If they paid more, the customer will get instructions on how to be refunded the difference.

​
sender_type
enum<string>
required

Type of the merchant's customer who sends the funds.

Use natural if the sender is an individual person and legal if the sender is a legal entity. The selected type determines which fields must be included in sender_data.

Available options:
natural,
legal
​
sender_data
object
required

Must contain the details of the merchant's customer who sends the funds.

  • If sender_type is natural, include first_name, last_name, and date_of_birth. Do not include legal_name or country_of_registration.
  • If sender_type is legal, include legal_name and country_of_registration. Do not include first_name, last_name, or date_of_birth.
​
type
enum<string>

For partial pay invoices, set this parameter to good_until_expired. For standard invoices, use fill_or_kill or leave this parameter empty.

Available options:
fill_or_kill,
good_until_expired
​
description
string

Invoice description that the customer will see.

Maximum string length: 1000
​
sender_currency
string

Currency the customer will pay in. If provided together with timer: true, the invoice is created with a fixed payment currency.

Response

Created

​
data
object
Last modified on June 29, 2026