💰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 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

  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. Webhook body represents payment model. Please refer to webhook section to get more details.

If no webhook settings specified, you can retrieve payment status via GET endpoint

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

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

Example API Response. Create h2h payin

{
  "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)

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

Example API Response. Pass card data

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

Last updated