Create a payment request - CryptoProcessing

curl --request POST \ --url https://app.cryptoprocessing.com/api/payments/v1/requests \ --header 'Content-Type: application/json' \ --header 'X-Processing-Key: <api-key>' \ --header 'X-Processing-Signature: <x-processing-signature>' \ --data ' { "amount": "100", "currency": { "iso": "EUR" }, "life_time_duration": 360000, "end_user_email": "[email protected]", "description": "Order 0512", "foreign_id": "test_foreign_id_0512", "url_store": "https://example.com/store", "end_user_reference": "user_12345", "sender_type": "legal", "sender_data": { "legal_name": "Example GmbH", "country_of_registration": "DEU" } } '

{ "data": { "id": "019d511c-9fd2-7e71-b534-74e8abd855f1", "amount": "100", "currency": { "iso": "EUR" }, "status": "created", "life_time": 1775542323, "end_user_email": "[email protected]", "description": "Order 0512", "payment_link": "https://payments.cryptoprocessing.com/payment/lLXLZ6Q8lCwFFRbyW0C1ET", "foreign_id": "test_foreign_id_0512", "url_store": "https://example.com/store", "end_user_reference": "user_12345" } }

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

amount

string

required

Payment request amount that you want to receive from the customer.

Example:

"100.50"

currency

object

required

The currency you want to receive.

Show child attributes

life_time_duration

integer

required

Payment request lifetime (duration in seconds). Include either this parameter or life_time_datetime. At least one of these fields is required.

Example:

3600

life_time_datetime

integer

required

Payment request lifetime (exact expiry timestamp). Include either this parameter or life_time_duration. At least one of these fields is required.

Example:

1773768946

payment_currency

object

The currency your customer will pay in. You can set both the currency and network or just the currency.

Show child attributes

end_user_email

string

If the amount the customer pays does not match the amount that you set for the payment request, 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.

Example:

"[email protected]"

end_user_reference

string

The unique ID of the customer this payment request is for. You can use it to group payment requests by customer.

sender_type

enum<string>

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 if sender_type is provided. Must contain the details of the merchant's customer who sends the funds.

If sender_type is natural, include first_name, last_name, and optionally 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.

Show child attributes

description

string

Payment request description that the customer will see.

Example:

"Order #123"

foreign_id

string

Unique foreign ID in your system. Must not contain personal data, such as the user's name or email address.

Example:

"order_123"

url_store

string

URL of the store page. The customer can click a button on the payment form to return to this URL (for example, if they change their mind or want to pick a different payment method). We recommend setting this to the URL of the checkout page.

Example:

"example.com/store"

url_success

string

URL of the success page. The customer will be able to return to this address once the payment is completed.

Example:

"example.com/success"

url_failed

string

URL of the failed payment page. The customer will be able to return to this address if the payment fails.

Example:

"example.com/fail"

Response

data

object

Show child attributes