# Host-to-Host integration

## Request address <a href="#request-address" id="request-address"></a>

**Deposits**

<mark style="color:green;">`POST`</mark>

```url
https://api.mvpgateways.com/v2/payment/deposit/
```

**Payouts**

<mark style="color:green;">`POST`</mark>

```url
https://api.mvpgateways.com/v2/payment/payout/
```

## Headers <a href="#headers" id="headers"></a>

```json
{
    "Content-Type": "application/json",
    "MERCHANT_KEY": "***"
}
```

{% hint style="info" %}
Merchant key will be provided to you by your Cabbagino manager
{% endhint %}

## Main request parameters <a href="#main-request-parameters" id="main-request-parameters"></a>

#### Request example

```json
{
   "payment_system": "TEST_PS",
    "external_id": "{{external_id}}",
    "customer": {
        "customer_id": "test",
        "country": "**",
        "first_name": "Test",
        "last_name": "Test"
    },
    "amount": 1100000,
    "currency": "USD",
    "signature": "signature"
}
```

<table data-full-width="true"><thead><tr><th width="200.5703125">Parameter</th><th width="132.69140625">Mandatory</th><th width="168.46875">Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>payment_system</td><td>Yes</td><td>String</td><td>Unique ID of the payment method, is provided by your Cabbagino manager</td><td>TEST_PS</td></tr><tr><td>external_id</td><td>Yes</td><td>String</td><td>Client side order id</td><td>“1234512123124”</td></tr><tr><td>amount</td><td>Yes</td><td>Integer</td><td><p></p><p>Transaction amount in minor units</p><p><sup>For JPY, CLP, ECS, VND, KRW, ISK, PYG — use whole numbers</sup></p></td><td><p></p><p>2000 (= 20.00) </p><p><sup>except JPY, CLP, ECS, VND, KRW, ISK, PYG, where 2000 = 2000.00</sup></p></td></tr><tr><td>currency</td><td>Yes</td><td>alpha-3 ISO 4217</td><td>Purchase currency.</td><td>USD</td></tr><tr><td>customer</td><td>Yes</td><td>Object</td><td>Object containing client information</td><td><p>“customer”: {</p><p>“customer_id”: “JohnDoe”,</p><p>“country”: “LV”,</p><p>“first_name”: “Test”,</p><p>“last_name”: “Test”</p><p>}</p></td></tr></tbody></table>

## Additional parameters depending on the payment method <a href="#additional-parameters-depending-on-the-payment-method" id="additional-parameters-depending-on-the-payment-method"></a>

### Bank Cards <a href="#bank-cards" id="bank-cards"></a>

**Deposits**

```json
"payment_data": {
        "card_number": "4111111111111111",
        "card_holder": "John Doe",
        "exp_year": "2028",
        "exp_month": "06",
        "cvv": "123"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>card_number</td><td>Yes</td><td>String</td><td>Card number</td><td>see <a href="/pages/xaoRdXIKMjrM6djENDiq">test card numbers</a></td></tr><tr><td>card_holder</td><td>Yes</td><td>String</td><td>Name of the card holder</td><td>John Doe</td></tr><tr><td>exp_year</td><td>Yes</td><td>String</td><td>Expiration year</td><td>2028</td></tr><tr><td>exp_month</td><td>Yes</td><td>String</td><td>Expiration month</td><td>06</td></tr><tr><td>cvv</td><td>Yes</td><td>String</td><td>Card security code</td><td>123</td></tr></tbody></table>

**Bank Cards 3DS response example**

```json
{
  "redirect": "https://example.com",
  "status": 3,
  "type": 1,
  "external_id": "1abcdE2fg3",
  "order_id": "123456789012345678901234567890"
}
```

**Payouts**

```json
"payment_data": {
        "card_number": "4111111111111111",
        "card_holder": "John Doe",
        "exp_year": "2028",
        "exp_month": "06"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>card_number</td><td>Yes</td><td>String</td><td>Card number</td><td>4111111111111111</td></tr><tr><td>card_holder</td><td>Yes</td><td>String</td><td>Name of the card holder</td><td>John Doe</td></tr><tr><td>exp_year</td><td>Yes</td><td>String</td><td>Expiration year</td><td>2028</td></tr><tr><td>exp_month</td><td>Yes</td><td>String</td><td>Expiration month</td><td>06</td></tr></tbody></table>

{% tabs %}
{% tab title="200:Successful response" %}

```json
{
  "display_data": {
    "card": "4111111111111111",
    "card_holder": "John Doe",
    "bank_name": "American Express"
  },
  "status": 1,
  "type": 1,
  "external_id": "BoUQswzcmH",
  "order_id": "172284927627647225983547588979"
}
```

{% endtab %}

{% tab title="400:Unsuccessful response" %}

```json
{
    "error_code": "default",
    "error_message": "Declined. Please contact support for more details.",
    "status": 5,
    "type": 1,
    "external_id": "SzOQVzA724",
    "order_id": "172285043660926720456112753953"
}
```

{% endtab %}
{% endtabs %}

<details>

<summary>List of available bank names for AZN customers</summary>

* AccessBank
* AFB Bank
* AGBank
* Amrahbank
* AtaBank
* Azer Turk Bank
* Bank Avrasiya
* Bank BTB
* Bank of Baku
* Bank Respublika
* Expressbank
* Xalq Bank
* Kapital bank
* NBCBank
* Bank Silk Way
* Rabitebank
* TuranBank
* Yapi Kredi Bank
* Ziraat Bank
* ИКБ NIKOIL BANK
* Bank VTB
* ABB Bank
* ATB ban

</details>

### P2P Bank Card

**Deposits**

{% hint style="info" %}
Deposit request for P2P Bank Card is same as [main request](#main-request-parameters)
{% endhint %}

**Response examples**

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://example.com",
  "status": 3,
  "type": 1,
  "external_id": "673937ebbb2d264e6bb8f7f04fd6c485",
  "order_id": "175042241278345064345373647881"
}
```

{% endtab %}

{% tab title="H2H" %}

```json
{
  "display_data": {
    "card": "4111111111111111",
    "card_holder": "John Doe",
    "bank_name": "PayBank"
  },
  "status": 3,
  "type": 1,
  "external_id": "01978cc8-5105-7588-a903-b6978a61900b",
  "order_id": "175041362867575119426449087551"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

```json
"payment_data": {
    "bank_name": "Sberbank",
    "card_number": "4111111111111111",
    "card_holder": "John Doe"
}
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th width="164">Description</th><th>Example</th></tr></thead><tbody><tr><td>bank_name</td><td>Yes</td><td>String</td><td>Name of the bank</td><td>Sberbank</td></tr><tr><td>card_number</td><td>Yes</td><td>String</td><td>Card number</td><td>4111111111111111</td></tr><tr><td>card_holder</td><td>Yes</td><td>String</td><td>Name of the card holder</td><td>John Doe</td></tr></tbody></table>

**Response examples**

<pre class="language-json"><code class="lang-json"><strong>{
</strong>  "status": 3,
  "type": 2,
  "external_id": "05ec7a76bad9d96112e2593830ffc7e9",
  "order_id": "175040565608186698365302451169"
}
</code></pre>

### SBP

**Deposits**

{% hint style="info" %}
Deposit request for SBP is same as [main request](#main-request-parameters)
{% endhint %}

**Response examples**

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://example.com",
  "status": 3,
  "type": 1,
  "external_id": "673937ebbb2d264e6bb8f7f04fd6c485",
  "order_id": "175042241278345064345373647881"
}
```

{% endtab %}

{% tab title="H2H" %}

```
{
  "display_data": {
    "card": "79627077172",
    "card_holder": "Валерий П",
    "bank_name": "Alfa-bank"
  },
  "status": 3,
  "type": 1,
  "external_id": "u45TFZQO8B",
  "order_id": "175101707967825789884834506946"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

```json
"payment_data": {
    "phone": "+79112326677",
    "holder": "FFF HJJJ",
    "bank_name": "VTB"
  }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>phone</td><td>Yes</td><td>String</td><td>Card holder's phone number</td><td>+79112326677</td></tr><tr><td>holder</td><td>Yes</td><td>String</td><td>Name of the card holder</td><td>FFF HJJJ</td></tr><tr><td>bank_name</td><td>Yes</td><td>String</td><td>Name of the bank</td><td>VTB</td></tr></tbody></table>

**Response examples**

```json
{
  "status": 3,
  "type": 2,
  "external_id": "05ec7a76bad9d96112e2593830ffc7e9",
  "order_id": "175040565608186698365302451169"
}
```

### VegaWallet <a href="#vegawallet" id="vegawallet"></a>

**Deposits**

```json
"payment_data": {
        "wallet": "U000060",
        "password": "jDgBvkukPAPJXiAg"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>U000060</td></tr><tr><td>password</td><td>Yes</td><td>String</td><td>Password of the wallet</td><td>jDgBvkukPAPJXiAg</td></tr></tbody></table>

**Payouts**

```json
"payment_data": {
        "wallet": "U000060",
        "password": "jDgBvkukPAPJXiAg"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>U000060</td></tr><tr><td>password</td><td>Yes</td><td>String</td><td>Password of the wallet</td><td>jDgBvkukPAPJXiAg</td></tr></tbody></table>

### JetonWallet <a href="#jetonwallet" id="jetonwallet"></a>

**Deposits**

```json
"payment_data": {
        "wallet": "12345678"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>12345678</td></tr></tbody></table>

**Payouts**

```json
"payment_data": {
        "wallet": "12345678"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>12345678</td></tr></tbody></table>

### EcoPayz <a href="#ecopayz" id="ecopayz"></a>

**Payouts**

```json
"payment_data": {
        "wallet": "1100383615"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>1100383615</td></tr></tbody></table>

### SticPay <a href="#sticpay" id="sticpay"></a>

**Payouts**

```json
"payment_data": {
        "wallet": "jdoe@example.com"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>wallet</td><td>Yes</td><td>String</td><td>Wallet id</td><td>jdoe@example.com</td></tr></tbody></table>

### Emanat <a href="#emanat" id="emanat"></a>

**Deposits**

{% hint style="info" %}
Deposit request for Emanat is same as [main request](#main-request-parameters)
{% endhint %}

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://example.com",
  "status": 3,
  "type": 1,
  "external_id": "673937ebbb2d264e6bb8f7f04fd6c485",
  "order_id": "175042241278345064345373647881"
}
```

{% endtab %}

{% tab title="H2H" %}

```json
{
    "display_data": {
        "card": "1111****1111",
        "card_holder": "John Doe",
        "bank_name": "Emanat"
    },
    "status": 3,
    "type": 1,
    "external_id": "1abcdE2fg3",
    "order_id": "123456789012345678901234567890"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

```json
"payment_data": {
        "phone": "994934331504"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>phone_number</td><td>Yes</td><td>String</td><td>Phone number</td><td>994934331504</td></tr></tbody></table>

### M10Wallet <a href="#m10wallet" id="m10wallet"></a>

**Deposits**

{% hint style="info" %}
Deposit request for M10Wallet is same as [main request](#main-request-parameters)
{% endhint %}

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://example.com",
  "status": 3,
  "type": 1,
  "external_id": "673937ebbb2d264e6bb8f7f04fd6c485",
  "order_id": "175042241278345064345373647881"
}
```

{% endtab %}

{% tab title="H2H" %}

```json
{
    "display_data": {
        "card": "999999999999",
        "card_holder": "John Doe",
        "bank_name": "M10"
    },
    "status": 3,
    "type": 1,
    "external_id": "0196a958-12b5-739d-8873-0c9716d5d097",
    "order_id": "174659784411080612856996555274"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

```json
"payment_data": {
        "phone": "994934331504"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>phone</td><td>Yes</td><td>String</td><td>Phone number</td><td>994934331504</td></tr></tbody></table>

{% hint style="info" %}
For the [Emanat](https://docs.carouseller.com/carouseller/payment-api/api-2.0#emanat) and [M10Wallet](https://docs.carouseller.com/carouseller/payment-api/api-2.0#m10wallet) there is validation for the phone parameter: `^994\d{9}$`
{% endhint %}

### FastHavale

**Available Banks request**

**Request address**

<mark style="color:green;">`POST`</mark>&#x20;

```url
https://x.cabbagino.com/external_clients/get_banks/deposit/
```

**Request example**

```json
{
    "payment_system": "TEST_PS",
    "customer": {
        "customer_id": "vnkshr7493455hjfk0285",
        "country": "JP",
        "first_name": "Dan",
        "last_name": "Nad",
    },
    "amount": 4000,
    "currency": "TRY",
    "signature": "signature"
}
```

**Response example**

{% code expandable="true" %}

```json
{
    "bank_names": [
        [
            "1",
            "AKBANK"
        ],
        [
            "2",
            "ALBARAKATURK"
        ],
        [
            "4",
            "GARANTİ BANKASI"
        ],
        [
            "5",
            "HALK BANKASI"
        ],
        [
            "6",
            "ICBC"
        ],
        [
            "7",
            "İŞ BANKASI"
        ],
        [
            "8",
            "FİNANSBANK"
        ],
        [
            "10",
            "TEB"
        ],
        [
            "13",
            "VAKIFBANK"
        ],
        [
            "14",
            "YAPIKREDİ"
        ],
        [
            "15",
            "ZİRAAT BANKASI"
        ],
        [
            "16",
            "KUVEYTTURK"
        ],
        [
            "23",
            "TRFINANS"
        ],
        [
            "26",
            "ODEABANK"
        ],
        [
            "31",
            "EMLAK KATILIM"
        ],
        [
            "32",
            "Ziraat Katılım"
        ]
    ]
}
```

{% endcode %}

**Deposits**

**Request example**

```json
{
    "payment_system": "TEST_ME",
    "external_id": "mms6",
    "customer": {
        "customer_id": "vnkshr749285hjfk0285",
        "country": "TR",
        "first_name": "Dan",
        "last_name": "Nad"
    },
    "payment_data": {
        "owner_name": "Some Guy"
    },
    "amount": 8000,
    "currency": "EUR",
    "signature": "signature"
}
```

**Payouts**

**Request example**

```json
{
    "payment_system": "TEST_FASTHAVALE",
    "external_id": "mms6",
    "customer": {
        "customer_id": "vnkshr7493455hjfk0285",
        "country": "TR",
        "first_name": "Dan",
        "last_name": "Nad"
    },
     "payment_data": {
        "bank_code": "NXS",
        "owner_name": "AKREN VUDLY",
        "account_number": "TR340001500158007309417646"

    },
    "amount": 8000,
    "currency": "TRY",
    "signature": "signature"
}
```

### Mobile Commerce

**Deposits**

**Request example**

```json
{
  "payment_system": "TEST",
  "external_id": "UcdQ05eX4X",
  "amount": 23000,
  "currency": "JPY",
  "customer": {
    "customer_id": "vnkshr7493455hjfk0285",
    "country": "JP",
    "first_name": "John",
    "last_name": "Smith"
  },
  "payment_data": {
    "phone": "994934331504"
  },
  "signature": "eef5e5667bb3586c3db415018f62b4a8be31a3aa"
}
```

### Community Payments

**Available Banks request**

**Request address**

<mark style="color:green;">`POST`</mark>&#x20;

```url
https://api.mvpgateways.com/gateways/banks/community_payments/
```

**Request example**

```json
{
    "payment_system": "CommunityPayment_Provider",
    "country": "JP",
    "signature": "signature"
}
```

**Response example**

```json
{
    "bank_name": "Aichi Bank(愛知銀行",
    "swift": "AICHJPJN",
    "amount_list": [
        {
            "id": 136165236,
            "amount": 225,
            "currency": "JPY"
        },
        {
            "id": 136165248,
            "amount": 300,
            "currency": "JPY"
        },
        {
            "id": 136165255,
            "amount": 3000,
            "currency": "JPY"
        },
```

**Deposits**

**Request example**

```json
{
  "payment_system": "CommunityPayment_Provider",
  "external_id": "as4uQI5stm",
  "customer": {
    "customer_id": "vnkshr7493455hjfk0285",
    "country": "JP",
    "first_name": "Dan",
    "last_name": "Nad"
  },
  "payment_data": {
    "bank_code": "AICHJPJN",
    "active_amount_id": "136128364"
  },
  "amount": 225,
  "currency": "JPY",
  "signature": "87cbdb57db53c687945d3ba3129a98229f93535f"
}
```

**Response example**

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://api.mvpgateways.com/v2/redirect/370777/",
  "status": 1,
  "type": 1,
  "external_id": "as4uQI5stm",
  "order_id": "176355095198568470363979085593"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

**Request example**

```json
{
  "payment_system": "CommunityPayment_Provider",
  "external_id": "PjEN2sUI9C",
  "customer": {
    "customer_id": "vnkshr7493455hjfk0285",
    "country": "JP",
    "first_name": "Dan",
    "last_name": "Nad"
  },
  "payment_data": {
    "owner_name": "John Doe",
    "owner_native_name": "シンイチ タケモト",
    "bank_code": "JANEJPJT",
    "account_number": "0064367147"
  },
  "amount": 225,
  "currency": "JPY",
  "signature": "d44f1e18d0922fde7a1714c8708ae78db10f785b"
}
```

### Cash <a href="#m10wallet" id="m10wallet"></a>

**Deposits**

**Request example**

```json
"payment_data": {
        "address": "Street 12",
        "messenger": "telegram",
        "username": "test",
        "asap": "true",
        "delivery_time": "2026-01-11 12:28:28"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>address</td><td>Yes</td><td>String</td><td>Address</td><td>Street 12</td></tr><tr><td>messenger</td><td>Yes</td><td>String</td><td>Messenger app</td><td>telegram</td></tr><tr><td>username</td><td>Yes</td><td>String</td><td>Username of the user</td><td>test</td></tr><tr><td>asap</td><td>Yes</td><td>String</td><td>Flag to indicate urgency</td><td>true</td></tr><tr><td>delivery_time</td><td>Yes</td><td>String</td><td>Delivery time</td><td>2025-01-11 12:28:28</td></tr></tbody></table>

**Payouts**

```json
"payment_data": {
        "address": "Street 12",
        "messenger": "telegram",
        "username": "test",
        "asap": "true",
        "delivery_time": "2026-01-11 12:28:28"
    }
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th>Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>address</td><td>Yes</td><td>String</td><td>Address</td><td>Street 12</td></tr><tr><td>messenger</td><td>Yes</td><td>String</td><td>Messenger app</td><td>telegram</td></tr><tr><td>username</td><td>Yes</td><td>String</td><td>Username of the user</td><td>test</td></tr><tr><td>asap</td><td>Yes</td><td>String</td><td>Flag to indicate urgency</td><td>true</td></tr><tr><td>delivery_time</td><td>Yes</td><td>String</td><td>Time when the transaction was completed</td><td>2025-01-11 12:28:28</td></tr></tbody></table>

### CIS Transfers <a href="#payment-method-ids" id="payment-method-ids"></a>

{% hint style="info" %}
No additional payment data is required, but integration type can only be redirect.
{% endhint %}

**Request example**

```json
{
   "payment_system": "TEST_PS",
    "external_id": "{{external_id}}",
    "customer": {
        "customer_id": "test",
        "country": "**",
        "first_name": "John",
        "last_name": "Doe"
    },
    "amount": 1100000,
    "currency": "USD",
    "signature": "signature"
}
```

### Bank Transfer <a href="#m10wallet" id="m10wallet"></a>

**Deposits**

**Request example**

```json
"payment_data": {
    "owner_name":"John Doe",
    "owner_native_name": "모짜렐라 치"
}
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th width="144.25">Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>owner_name</td><td>Yes</td><td>String</td><td>Account owner name</td><td>John Doe</td></tr><tr><td>owner_native_name</td><td>Yes</td><td>String</td><td>Account owner native name</td><td>모짜렐라 치</td></tr></tbody></table>

**Response example**

{% tabs %}
{% tab title="Redirect" %}

```json
{
  "redirect": "https://example.com",
  "status": x,
  "type": x,
  "external_id": "**",
  "order_id": "**"
}
```

{% endtab %}
{% endtabs %}

**Payouts**

**Request example**

```json
"payment_data": {
    "account_number": "**",
    "owner_name": "John Doe",
    "owner_native_name": "모짜렐라 치",
    "bank_name": "**",
    "branch_name": "**",
    "bank_code": "**"
}
```

<table data-full-width="true"><thead><tr><th>Parameter</th><th>Mandatory</th><th width="142.53125">Format</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>account_number</td><td>Yes</td><td>String</td><td>Phone number</td><td>1234567890</td></tr><tr><td>owner_name</td><td>Yes</td><td>String</td><td>Account owner name</td><td>John Doe</td></tr><tr><td>owner_native_name</td><td>Yes</td><td>String</td><td>Account owner native name</td><td>John Doe</td></tr><tr><td>bank_name</td><td>Yes</td><td>String</td><td>Name of the bank</td><td>Test Bank</td></tr><tr><td>branch_name</td><td>Yes</td><td>String</td><td>Bank branch name</td><td><em>Check with manager for details</em></td></tr><tr><td>bank_code</td><td>Yes</td><td>String</td><td>Bank code</td><td><em>Check with manager for details</em></td></tr></tbody></table>

**Response example**

```json
{
 "status": x,
 "type": x,
 "external_id": "**",
 "order_id": "**"
}
```

### **KRVirtualAccounts**

**Deposits**

**Request address**

<mark style="color:green;">`POST`</mark>

```
https://api.mvpgateways.com/v2/payment_page/deposit/
```

**Request example**

```json
{
    "payment_system": "Payment_System", 
    "external_id": "12345",
    "amount": 1000,
    "customer": {
        "customer_id": "user",
        "country": "KR",
        "first_name": "수진",
        "last_name": "강진"
    },
    "urls": {
     "redirect_decline_url": "https://www.example.com",
     "redirect_success_url": "https://www.example.com",
     "redirect_processing_url": "https://www.example.com",
     "notify_url": "https://example.com/"
    },
    "currency": "KRW",
    "signature": "signature"
}
```

**Response example**

```json
{
    "redirect_url": "https://x.cabbagino.com/v2/?key=eyJybmQiOiAiOTQyZjlhNTQtNjhhNy00Zjg1LWJmZjgtYzkyZmI5ZjU1OTI0In0.aTGKwA._yPG_WA-3trjhowtDaQCpr42d3M#/deposit_methods/payment/1207/external/mvp-gateways/19448",
    "order_id": "117648544647405022384130200112",
    "external_id": "HxvikLiBC6"
}
```

**Payouts**

**Available Banks request**

**Request address**

<mark style="color:green;">`POST`</mark>

```
https://x.cabbagino.com/external_clients/get_banks/deposit/
```

**Request example**

```json
{
    "payment_system": "Payment_System",
    "customer": {
        "customer_id": "user",
        "country": "KR",
        "first_name": "Name",
        "last_name": "Surname"
    },
    "amount": 1000,
    "currency": "KRW",
    "signature": "signature"
}
```

**Response example**

{% code expandable="true" %}

```json
{
    "bank_names": [
        "Busan Bank",
        "BNK Kyongnam Bank",
        "Daegu Bank",
        "Gwangju Bank",
        "IBK Bank",
        "Jeju Bank",
        "Jeonbuk Bank",
        "Kookmin Bank",
        "Korea Post Office Banking Service",
        "NongHyup Bank",
        "Suhyup Bank",
        "Shinhan Bank",
        "Woori Bank",
        "KEB Hana Bank",
        "KakaoBank",
        "K Bank",
        "Credit Union",
        "Korean Federation of Community Credit Cooperatives",
        "The Hongkong and Shanghai Banking Corporation Limited",
        "Citibank Korea",
        "Standard Chartered",
        "National Forestry Cooperative Federation",
        "J.P. Morgan Korea",
        "Korea Development Bank",
        "Industrial and Commercial Bank of China Limited",
        "Toss Bank",
        "Bank of America",
        "BNP Paribas Bank",
        "Deutsche Bank"
    ]
}
```

{% endcode %}

**Payout request example**

```json
{
    "payment_system": "Payment_System",
    "external_id": "12345",
    "customer": {
        "customer_id": "user",
        "country": "KR",
        "first_name": "Name",
        "last_name": "Surname"
    },
    "payment_data": {
        "account_number": "123456789",
        "bank_name": "Bank",
        "owner_name": "Name Surname",
        "owner_native_name": "모짜렐라 치"
    },
    "amount": 4000,
    "currency": "KRW",
    "signature": "signature"
}
```

### Local Bank Transfers

**Available Banks request**

**Request address**

<mark style="color:green;">`POST`</mark>&#x20;

```url
https://x.cabbagino.com/external_clients/get_banks/deposit/
```

**Request example**

```json
{
    "payment_system": "TEST_PS",
    "customer": {
        "customer_id": "vnkshr7493455hjfk0285",
        "country": "JP",
        "first_name": "Dan",
        "last_name": "Nad",
    },
    "amount": 4000,
    "currency": "USD",
    "signature": "signature"
}
```

**Response example**

{% code expandable="true" %}

```json
{
    "bank_names": [
        "86400 Holdings Pty Ltd(Acquired by NAB)",
        "Adelaide Bank (a division of Bendigo and Adelaide Bank Ltd)",
        "Advance Bank Australia- a division of Westpac Banking Corp",
        "Alex Bank Pty Ltd",
        "AMP Bank Ltd",
        "Any Bank Australia (BSB Payout)",
        "Arab Bank Australia Ltd",
        "Australia and New Zealand Banking Group Ltd",
        "Australia Post(Money Orders)",
        "Australian Military Bank Ltd",
        "Australian Mutual Bank Ltd",
        "Australian Mutual Bank Ltd-U",
        "Australian Settlements Ltd",
        "Australian Unity Bank Ltd",
        "Auswide Bank Ltd",
        "Auswide Bank Ltd-U",
        "Avenue Bank Ltd",
        "B and E Ltd trading as Bank of Us",
        "Bank Australia Ltd",
        "Bank of America National Association",
        "Bank of China",
        "Bank of China (Australia) Ltd",
        "Bank of Communications Co. Ltd Sydney Branch",
        "Bank of Heritage Isle a division of Police Bank Ltd",
        "Bank of Melbourne - a division of Westpac -U",
        "Bank of Melbourne- a division of Westpac Banking Corp",
        "Bank of Queensland Ltd",
        "Bank of Sydney Ltd",
        "Bank SA - a division of Westpac Banking Corp",
        "Bankers Trust Australia- a division of Westpac Banking Corp",
        "Bankwest (a division of Commonwealth Bank of Australia)",
        "Bendigo and Adelaide Bank Ltd",
        "Beyond Bank Australia Ltd",
        "BNP Paribas",
        "BNP Paribas Securities Services",
        "BOQ Specialist (a division of Bank of Queensland Ltd)",
        "Capricornian Ltd (The)",
        "Challenge Bank- a division of Westpac Banking Corp",
        "China Construction Bank Corporation Sydney Branch",
        "Citibank",
        "Citibank N.A.",
        "Commonwealth Bank of Australia",
        "Commonwealth Bank of Australia-U",
        "Community First Credit Union Ltd",
        "Credit Union Australia Ltd (trading as Great Southern Bank)",
        "Cuscal Ltd",
        "Cuscal Ltd-U",
        "DBS Bank Ltd. (Australia Branch)",
        "Defence Bank Ltd",
        "Delphi Bank (a division of Bendigo and Adelaide Bank Ltd)",
        "Deutsche Bank Aktiengesellschaft",
        "G and C Mutual Bank Ltd",
        "Gateway Bank Ltd",
        "Global Payments Australia 1 Pty Ltd",
        "Greater Bank Ltd",
        "Heritage Bank Ltd",
        "Holiday Coast (now known as Regional Australia Bank Ltd)",
        "Home Building Society (a division of Bank of Queensland Ltd)",
        "Hongkong and Shanghai Banking Corp Ltd (The) Australian Branch",
        "HSBC Bank Australia Ltd",
        "Hume Bank Ltd",
        "IMB Ltd",
        "in1bank Ltd",
        "Indue Ltd",
        "Industrial and Commercial Bank of China Ltd",
        "ING Bank (Australia) Ltd (trading as ING)",
        "ING Bank NV (Sydney Branch)",
        "JP Morgan Chase Bank National Association",
        "Judo Bank Pty Ltd",
        "KEB Hana Bank",
        "Macquarie Bank Ltd",
        "Maitland Mutual Ltd trading as The Mutual Bank",
        "Mega International Commercial Bank Co Ltd",
        "Members Banking Group Ltd Trading as RACQ Bank",
        "Members Equity Bank Ltd (a division of Bank of Queensland Ltd)",
        "Mizuho Bank Ltd",
        "MUFG Bank Ltd.",
        "MyState Bank Ltd",
        "National Australia Bank Ltd",
        "Newcastle Permanent Building Society Ltd",
        "Oversea-Chinese Banking Corporation Ltd",
        "PAYID",
        "Pioneer Permanent Building Society",
        "Police and Nurses Ltd",
        "Police Bank Ltd (trading as Police Bank)",
        "Queensland Country Bank Ltd",
        "Rabobank Australia Ltd",
        "Railways Credit Union Ltd t/a MOVE Bank",
        "Regional Australia Bank Ltd",
        "Reserve Bank of Australia",
        "Southern Cross Credit Union Ltd",
        "St George Bank - a division of Westpac Banking Corp",
        "St George Bank- a division of Westpac Banking -U",
        "Standard Chartered Bank Australia Branch",
        "State Street Bank and Trust Company",
        "Sumitomo Mitsui Banking Corporation",
        "Summerland Financial(Trading as Summerland Credit Union)",
        "Suncorp-Metway Ltd",
        "Taiwan Business Bank Sydney Branch",
        "Teachers Mutual Bank Ltd"
    ]
}
```

{% endcode %}

**Payouts**

**Request example**

```json
{
    "payment_system": "TEST_PS",
    "external_id": "{{external_id}}",
    "customer": {
        "customer_id": "vnkshr749285hjfk0285",
        "country": "JP",
        "first_name": "Dan",
        "last_name": "Nad",
        "address": "testAddress",
        "city": "York",
        "email": "user@gmail.com",
        "phone": "0937444444",
        "postal_code": "042090",
        "state": "testState"
    },
    "payment_data": {
        "account_number": "123456789",
        "bank_name": "AMP Bank",
        "owner_name": "Some Guy",
        "branch_code": "123455"
    },
    "amount": 4000,
    "currency": "USD",
    "signature": "signature"
}
```

### KakaoPay <a href="#payment-method-ids" id="payment-method-ids"></a>

{% hint style="info" %}
Requires additional payment data, which is provided below the request example.
{% endhint %}

**Request example**

```json
{
    "payment_system": "TEST_PS", 
    "external_id": "{{external_id}}",
    "amount": ,
    "customer": {
        "customer_id": "**",
        "country": "**",
        "first_name": "John",
        "last_name": "Doe"
    },
    "currency": "**",
    "signature": "**"
}
```

**Additional payment data**

```json
},  
    "payment_data": {
        "email": "jdoe@example.com"
}
```

### NaverPay

{% hint style="info" %}
Requires additional payment data, which is provided below the request example.
{% endhint %}

```json
{
    "payment_system": "TEST_PS", 
    "external_id": "{{external_id}}",
    "amount": ,
    "customer": {
        "customer_id": "**",
        "country": "**",
        "first_name": "John",
        "last_name": "Doe"
    },
    "currency": "**",
    "signature": "**"
}
```

**Additional payment data**

<pre class="language-json"><code class="lang-json"><strong>},  
</strong>    "payment_data": {
        "email": "jdoe@example.com"
}
</code></pre>

### Toss

{% hint style="info" %}
Requires additional payment data, which is provided below the request example.
{% endhint %}

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "payment_system": "TEST_PS", 
    "external_id": "{{external_id}}",
    "amount": ,
    "customer": {
        "customer_id": "**",
        "country": "**",
        "first_name": "John",
        "last_name": "Doe"
    },
    "currency": "**",
    "signature": "**"
}
</code></pre>

**Additional payment data**

```json
},  
    "payment_data": {
        "email": "jdoe@example.com"
}
```

### PayCO

{% hint style="info" %}
Requires additional payment data, which is provided below the request example.
{% endhint %}

```json
{
    "payment_system": "TEST_PS", 
    "external_id": "{{external_id}}",
    "amount": ,
    "customer": {
        "customer_id": "**",
        "country": "**",
        "first_name": "John",
        "last_name": "Doe"
    },
    "currency": "**",
    "signature": "**"
}
```

**Additional payment data**

```json
},  
    "payment_data": {
        "email": "jdoe@example.com"
}
```


---

# 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.cabbagino.com/cabbagino/payment-api-2.0/host-to-host-integration.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.