> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mycashq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payin API Introduction

> Accept payments using CashQ Payin API powered by Approvely

## Overview

The CashQ Payin API allows you to accept card payments from your customers. We use **Approvely Gateway** as our payment processing partner to provide secure and reliable payment processing.

<Info>
  **Approvely API Documentation**

  The complete Approvely API documentation can be found here: [Approvely API Documentation](https://docs.approvelygateway.com/api/v2)
</Info>

## Key Features

<CardGroup cols={2}>
  <Card title="Card Payments" icon="credit-card">
    Accept major credit and debit cards securely
  </Card>

  <Card title="Tokenization" icon="shield">
    Secure card tokenization for PCI compliance
  </Card>

  <Card title="Real-time Processing" icon="bolt">
    Instant payment processing and confirmation
  </Card>

  <Card title="Sandbox Testing" icon="flask">
    Full sandbox environment for testing
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Tokenize Card Data">
    Use the Approvely tokenization form to securely collect card details and generate a nonce token
  </Step>

  <Step title="Create Charge">
    Send the nonce token to the charge endpoint along with transaction details
  </Step>

  <Step title="Receive Confirmation">
    Get instant confirmation of the payment status
  </Step>
</Steps>

## Supported Card Types

* Visa
* Mastercard
* American Express
* Discover

## Environments

| Environment | Base URL                                   | Purpose                 |
| ----------- | ------------------------------------------ | ----------------------- |
| Sandbox     | `https://api.sandbox.approvelygateway.com` | Testing and development |
| Production  | `https://banking.cashqbot.com`             | Live transactions       |

<Warning>
  **Important:** Always test your integration thoroughly in the sandbox environment before going live.
</Warning>

## Getting Started

<Card title="Authentication Setup" icon="key" href="/payin/authentication">
  Learn how to get your API credentials and authenticate requests
</Card>

<Card title="Tokenization Guide" icon="shield" href="/payin/tokenization">
  Set up card tokenization for secure payment processing
</Card>

<Card title="Charge Endpoint" icon="bolt" href="/payin/charge">
  Process payments using the charge API
</Card>

## Security & Compliance

<AccordionGroup>
  <Accordion title="PCI Compliance">
    By using Approvely's tokenization, you reduce your PCI compliance scope. Card data never touches your servers directly.
  </Accordion>

  <Accordion title="Secure Communication">
    All API requests must use HTTPS. HTTP requests will be rejected.
  </Accordion>

  <Accordion title="API Authentication">
    All requests require Basic Authentication using your API Key and PIN.
  </Accordion>
</AccordionGroup>

## Need Help?

<Card title="Contact Support" icon="envelope" href="mailto:support@mycashq.com" horizontal>
  Questions about the Payin API? Our support team is here to help.
</Card>