# H2H Deposit/Payin

The **h2h payin** operation involves depositing funds into an account from cards via API.

#### Supported H2H Payin Methods

* **Card**\
  Deposit funds from a credit or debit card.

#### Payin Flow

1. **Initiate Payin**: Submit [a deposit request](https://apireference.inqud.com/#tag/h2h-operations/operation/user_h2h_create-payin) with the chosen method.
2. **Validation**: The system verifies the provided payment details (card number or wallet address).
3. **Pass Card Data:** Collect and [pass customer card data](https://apireference.inqud.com/#tag/h2h-operations/operation/user_h2h_create-cardPay) 
4. **Processing**: The deposit is processed and credited to the user's account.
5. **Notification**: If webhook settings specified, webhook is sent for each [status transition](/developer/payment-statuses.md). Webhook body represents [payment model](https://apireference.inqud.com/#tag/payments/operation/user_get-payment). Please refer to [webhook section](/developer/web-hooks.md) to get more details.<br>

If no webhook settings specified, you can retrieve payment status via [GET endpoint](https://apireference.inqud.com/#tag/payments/operation/user_get-payment)

#### Example API Request. Create h2h payin (See the API reference for more examples)

```json
{
    "amount": 100,
    "clientOrderId": "1234567890",
    "currency": "EUR",
    "method": "CC_VISAMC",
    "comment": "any comment",
    "returnUrl": "https://example.com/"
}
```

#### Example API Response. Create h2h payin

```json
{
  "amount": 100,
  "clientOrderId": "1234567890",
  "createdAt": "2022-12-01T12:00:00Z",
  "currency": "USD",
  "externalId": "c2544dd6e1c53529b877682127d16cff524f2867a57c5cc204e42eb2573e02e0",
  "h2H": true,
  "id": "PMT-b2e2df8c-281a-4cc1-2bcf-61b803358f0e",
  "method": "CC_VISAMC",
  "orderId": "ORD-b40c5710-c419-432b-9814-bac03cb4fe1c",
  "orderType": "PAYIN",
  "status": "NEW",
  "transactionType": "DEBIT"
}
```

#### Example API Request. Pass card data (See the API reference for more examples)

```json
{
    "card": {
        "cardHolder": "John Doe",
        "cvv": "123",
        "expMonth": 3,
        "expYear": 2031,
        "pan": "3566002020360505"
    },
    "email": "test@example.com"
}
```

#### Example API Response. Pass card data

```json
{
  "action": "REFRESH",
  "status": "ACCEPTED",
  "transactionId": "abcdefgh123456"
}
```


---

# Agent Instructions: 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:

```
GET https://docs.inqud.com/payments/h2h-deposit-payin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.