Host to host integration

Request address

Deposits

POST

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

Payouts

POST

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

Headers

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

Merchant key will be provided to you by your Cabbagino manager

Main request parameters

Request example

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

Parameter	Mandatory	Format	Description	Example
payment_system	Yes	String	Unique ID of the payment method, is provided by your Cabbagino manager.	TEST_PS
external_id	Yes	String	Client side order id	“1234512123124”
amount	Yes	Integer	Amount	20
currency	Yes	alpha-3 ISO 4217	Purchase currency	USD
customer	Yes	Object	Object containing client information	“customer”: { “customer_id”: “JohnDoe”, “country”: “LV”, “first_name”: “Test”, “last_name”: “Test” }

Additional parameters depending on the payment method

Bank Cards

Deposits

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

Parameter	Mandatory	Format	Description	Example
card_number	Yes	String	Card number	see test card numbers
card_holder	Yes	String	Name of the card holder	John Doe
exp_year	Yes	String	Expiration year	2028
exp_month	Yes	String	Expiration month	06
cvv	Yes	String	Card security code	123

Bank Cards 3DS response example

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

Payouts

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

Parameter	Mandatory	Format	Description	Example
card_number	Yes	String	Card number	4111111111111111
card_holder	Yes	String	Name of the card holder	John Doe
exp_year	Yes	String	Expiration year	2028
exp_month	Yes	String	Expiration month	06

200:Successful response

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

400:Unsuccessful response

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

List of available bank names for AZN customers

• 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

---

P2P Bank Card

Deposits

Deposit request for P2P Bank Card is same as main request

Response examples

Redirect

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

H2H

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

Payouts

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

Parameter	Mandatory	Format	Description	Example
bank_name	Yes	String	Name of the bank	Sberbank
card_number	Yes	String	Card number	4111111111111111
card_holder	Yes	String	Name of the card holder	John Doe

Response examples

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

VegaWallet

Deposits

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

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	U000060
password	Yes	String	Password of the wallet	jDgBvkukPAPJXiAg

Payouts

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

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	U000060
password	Yes	String	Password of the wallet	jDgBvkukPAPJXiAg

JetonWallet

Deposits

"payment_data": {
        "wallet": "12345678"
    }

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	12345678

Payouts

"payment_data": {
        "wallet": "12345678"
    }

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	12345678

EcoPayz

Payouts

"payment_data": {
        "wallet": "1100383615"
    }

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	1100383615

SticPay

Payouts

"payment_data": {
        "wallet": "[email protected]"
    }

Parameter	Mandatory	Format	Description	Example
wallet	Yes	String	Wallet id	[email protected]

Emanat

Deposits

Deposit request for Emanat is same as main request

Redirect

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

H2H

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

Payouts

"payment_data": {
        "phone": "994934331504"
    }

Parameter	Mandatory	Format	Description	Example
phone_number	Yes	String	Phone number	994934331504

M10Wallet

Deposits

Deposit request for M10Wallet is same as main request

Redirect

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

H2H

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

Payouts

"payment_data": {
        "phone": "994934331504"
    }

Parameter	Mandatory	Format	Description	Example
phone	Yes	String	Phone number	994934331504

For the Emanat and M10Wallet there is validation for the phone parameter: ^994\d{9}$

Cash

Deposits

"payment_data": {
        "address": "Street 12",
        "messenger": "Telegram",
        "username": "test",
        "asap": "true",
        "delivery_time": "2025-01-11 12:28:28"
    }

Parameter	Mandatory	Format	Description	Example
address	Yes	String	Address	Street 12
messenger	Yes	String	Messenger app	Telegram, WhatsApp
username	Yes	String	Username of the user	test
asap	Yes	String	Flag to indicate urgency	true
delivery_time	Yes	String	Delivery time	2025-01-11 12:28:28

Payouts

"payment_data": {
        "address": "Street 12",
        "messenger": "Telegram",
        "username": "test",
        "asap": "true",
        "delivery_time": "2025-01-11 12:28:28"
    }

Parameter	Mandatory	Format	Description	Example
address	Yes	String	Address	Street 12
messenger	Yes	String	Messenger app	Telegram, WhatsApp
username	Yes	String	Username of the user	test
asap	Yes	String	Flag to indicate urgency	true
delivery_time	Yes	String	Time when the transaction was completed	2025-01-11 12:28:28

CIS Transfers

No additional payment data is required, but integration type can only be redirect.

Request example

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

Deposits

"payment_data": {
    "owner_name":"John Doe",
    "owner_native_name": "John Doe"
}

Parameter	Mandatory	Format	Description	Example
owner_name	Yes	String	Account owner name	John Doe
owner_native_name	Yes	String	Account owner native name	John Doe

Payouts

"payment_data": {
    "account_number": "**",
    "owner_name": "John Doe",
    "owner_native_name": "John Doe",
    "bank_name": "**",
    "branch_name": "**",
    "bank_code": "**"
}

Parameter	Mandatory	Format	Description	Example
account_number	Yes	String	Phone number	1234567890
owner_name	Yes	String	Account owner name	John Doe
owner_native_name	Yes	String	Account owner native name	John Doe
bank_name	Yes	String	Name of the bank	Test Bank
branch_name	Yes	String	Bank branch name	Check with manager for details
bank_code	Yes	String	Bank code	Check with manager for details

Response examples

Deposit

For deposits, the response includes a link redirecting to the payment details page.

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

Payout

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

KakaoPay

Requires additional payment data, which is provided below the request example.

Request example

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

Additional payment data

},  
    "payment_data": {
        "email": "[email protected]"
}

NaverPay

Requires additional payment data, which is provided below the request example.

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

Additional payment data

},  
    "payment_data": {
        "email": "[email protected]"
}

Toss

Requires additional payment data, which is provided below the request example.

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

Additional payment data

},  
    "payment_data": {
        "email": "[email protected]"
}

PayCO

Requires additional payment data, which is provided below the request example.

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

Additional payment data

},  
    "payment_data": {
        "email": "[email protected]"
}