# 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](https://docs.inqud.com/developer/payment-statuses). Webhook body represents [payment model](https://apireference.inqud.com/#tag/payments/operation/user_get-payment). Please refer to [webhook section](https://docs.inqud.com/developer/web-hooks) 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"
}
```