About payment requests

See also: Create a payment request, About payment request refunds, Create a payment request refund, Payment request callbacks You can use payment requests to create invoices for your goods and services. Your customers will be able to pay in any cryptocurrency of their choice. Our system will automatically convert their payment to your preferred currency and credit it to your merchant account. You are guaranteed to receive the amount you requested in the currency you chose. When your customer opens the payment request, they will be prompted to choose their currency and network. CryptoProcessing will convert the amount you requested to this currency and display the total amount to pay. When your customer clicks Proceed to payment, the exchange rate will be locked for either an hour or your payment request’s lifespan (whichever is shorter). If no payment is placed within that window, you will need to create a new payment request. You will receive a callback when the payment transaction appears on the blockchain. Once the transaction is confirmed, CryptoProcessing will automatically convert the payment to your preferred currency and transfer it to your account. CryptoProcessing will also charge you a processing fee. You can keep track of your payment request status in the Payment requests tab of your merchant dashboard. You will receive callbacks when the customer chooses their currency and locks the rate, as well as when a payment transaction is detected and confirmed or when the payment requests fails or expires. You will also receive callbacks for late payments. For more details on payment request callbacks, see Payment request callbacks.

​

Late payments, overpayments and underpayments

If your customer underpays the payment request or pays too late, they will receive a full refund (minus the fees). You can create a new payment request for this customer. If they overpay, they will be able to request a partial refund for the overpaid amount, and the payment request will still be considered completed. CryptoProcessing will send the refund link to the email they provided when paying. You can also issue refunds for successfully completed payment requests from your merchant dashboard. For more details, see Refunds.

​

Payment requests with short and long lifespans

You can set a custom payment lifespan or a deadline for your payment request. CryptoProcessing will lock the exchange rate once the customer chooses their preferred payment currency, which protects you from market fluctuations.

​

What your customers will see

​

Payment requests with and without currency selection

By default, CryptoProcessing will always convert your customer’s payment to your preferred currency. For example, if you create a payment request for €100, your customer will be able to pay in any cryptocurrency of their choice. CryptoProcessing will automatically convert their deposit to EUR and send it to you. This way, you are always guaranteed to receive the amount you requested in your preferred currency while also offering your customers flexible payment options. Alternatively, you can choose a set currency (and/or network) your customer will be able to pay in. To do so, use the payment_currency API parameter. We recommend only doing this if your customer has already chosen their preferred currency somewhere in your app. If you want to limit a payment request to just one specific currency, include the payment_currency object when you create the payment request. This option is only available if you create the payment request through the API. You can preselect either both the currency and network or just the currency. For more details, see Create a payment request through the API.

​

About customising your payment request

Use these parameters to customise the payment request form:

​

Lifespan length

To set the length of your payment request’s lifespan, use the life_time_duration and life_time_date_time parameters. We recommend setting the lifespan length to at least 15 minutes. If your customers can pay in Bitcoin (BTC) or other currencies on networks with longer confirmation times, we suggest setting the lifetime to 60 minutes. This ensures your customers will have enough time to place the payment and have their transaction confirmed before the payment request expires.

​

Return buttons

You can include the url_store, url_success and url_failed parameters to help your customers navigate back to your site at any stage.