> For the complete documentation index, see [llms.txt](https://docs.cryptoix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cryptoix.io/accept-payments.md).

# Accept Payments

Cryptoix makes it easy for you to accept cryptocurrency payments. This guide explains the different ways you can set up and manage payments, and what to do if issues arise.

## Ways to Accept Payments

Cryptoix offers flexible ways to receive payments:

* **Hosted Checkout:** A secure, pre-built payment page that your customers are directed to. You can create these easily from your dashboard for individual sales or as a general payment option.
* **Payment Links/Pages:** Generate a unique link or page for a specific product or service. You can share this with your customers via email, social media, or embed it on your website.

## Create a Hosted Checkout Payment

You can create a payment directly from your Cryptoix dashboard. This is a quick way to get paid for a one-off transaction.

1. **Log in** to your Cryptoix dashboard.
2. Navigate to the section for creating new payments or transactions.
3. **Enter the payment details:** Specify the amount, the currency you wish to receive (e.g., USD, EUR), and add a description for your reference.
4. **Select the cryptocurrency** you want to accept for this payment.
5. Click the button to **Create Payment**.

Cryptoix will then generate a unique payment page for your customer.

## Share a Payment Page or Link

Once a payment is created, you can share it with your customer.

* **Hosted Checkout:** After creating a payment, you'll receive a link to the hosted checkout page. Copy this link and send it directly to your customer via email, messaging app, or any other communication channel.
* **Payment Links:** You can create standalone payment links for specific items or services. These links can be embedded on your website, shared in marketing materials, or sent directly to customers.

When your customer visits the payment page or clicks the link, they will see the payment details and instructions on how to complete the transaction.

## Customer Checkout Flow

When your customer is ready to pay, they will follow these steps:

1. **View Payment Details:** The customer clicks on the payment link or is directed to the hosted checkout page. They will see the amount due in your chosen currency and the specific cryptocurrency and amount they need to send.
2. **Select Cryptocurrency:** If the checkout page offers multiple cryptocurrency options, the customer selects the one they wish to use. If only one is shown, they will use that currency.
3. **Send Funds:** The customer will be provided with a unique wallet address and often a QR code. They will use their own cryptocurrency wallet to send the exact amount to this address.
4. **Confirmation:** Once the customer sends the funds, they will need to wait for the transaction to be confirmed on the blockchain. The payment page will update automatically as confirmations are received.

## Payment Statuses

Your payments will go through several statuses as they are processed:

* **Pending:** The payment has been created, but the customer has not yet sent the funds, or the funds have been sent but are still awaiting the necessary blockchain confirmations.
* **Paid:** Sufficient payment has been detected on the blockchain, but it may not have reached the required number of confirmations yet.
* **Confirmed:** The payment has reached the required number of blockchain confirmations and is considered final. The funds are ready for settlement.
* **Expired:** The customer did not send the payment within the allotted time.
* **Failed:** The payment could not be processed successfully for an unexpected reason.
* **Refunded:** The payment has been fully or partially refunded to the customer.

## Confirmations and Settlement

* **Blockchain Confirmations:** When a customer sends a cryptocurrency payment, it needs to be confirmed on the blockchain. The number of confirmations required can vary depending on the cryptocurrency network. **Please note that blockchain confirmation times can vary significantly.** Some networks are very fast, while others may take longer.
* **Settlement:** Once a payment is fully confirmed, the funds will be settled into your Cryptoix merchant account. You can then view your updated balance in your dashboard.

## Expired or Underpaid Payments

It's important to know how to handle situations where payments aren't completed exactly as expected.

* **Expired Payments:** If a payment expires (meaning the customer didn't send funds in time), the payment record in your dashboard will be marked as expired. If the customer contacts you later with payment, review the transaction details in your dashboard. Do not fulfill the order until you have confirmed the payment or decided on a resolution according to your own policies.
* **Underpaid Payments:** If a customer sends less than the required amount, the payment will typically remain in a pending state.
  * **What to do:** If a customer contacts you about an underpayment, ask them for details: the payment ID, the amount they sent, the cryptocurrency and network used, and the approximate time they sent it. Compare this information with the payment details in your dashboard. Do not mark the order as fulfilled unless the payment reaches the required amount and status. If you need to resolve this manually, follow your internal business policies. If you require assistance from the platform operator, provide them with all collected details and the transaction ID.
* **Late Payments:** If a customer sends funds after the payment has expired, please ask them to provide you with the transaction details (amount, currency, network, transaction ID/hash). Review these details against the expired payment in your dashboard. You will need to decide how to proceed based on your business policies. If the customer contacts support, advise them to provide you with all relevant transaction information so you can investigate and determine the best course of action. You may need to escalate to the platform administrator if a resolution cannot be reached.
* **Overpaid Payments:** If a customer sends more than the required amount, this is an unusual situation. Please review the transaction details in your dashboard. You will need to decide how to handle the excess funds according to your internal policies. If you need assistance from the platform operator, provide them with all relevant transaction details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cryptoix.io/accept-payments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
