Monobank

Website: monobank.ua

Set up Account H2H merchant account

Step 1: Create Merchant Account

To create an account send connection request at the monobank.ua/contacts or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get your Monobank Webhook key

1. Open Postman (or another API request tool).
2. Create a new request.
3. Set the method to GET.
4. In the URL field, enter: api.monobank.ua/api/merchant/pubkey
5. In the Headers tab, add the header 'X-Token' with the value of your Monobank Token.
6. Click Send to execute the request.
7. In the response, you will see a key value. Copy this value and use it as your Webhook key during integration.

Step 3: Get required credentials

Credentials that have to be issued:

• monobank__merchant_id → Merchant ID (This is a custom value you choose yourself. It serves as an identifier for your account in our system)
• monobank__api_token → Token
• monobank__webhook_key → Webhook key
• monobank__test_mode → Test Mode
• monobank__currency → choose currency (You can set these parameters according to available currencies and features for your Monobank wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

"Having issues with your credentials?" Please contact our support team!

Connect Merchant Account

Step 1. Connect H2H account at the Corefy Dashboard

Press Connect at Monobank Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Enter credentials:

• Merchant ID
• API token
• Webhook Key
• Test Mode → True/False
• Currency

You have connected Monobank H2H merchant account!

API examples:

Minimum data set to create a payment invoices for payment_card_eur_hpp service

SALE

POST /api/payment-invoices HTTP/1.0
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1f2aa3ca-abd8-4741-980d-4017ed30cb8c",
      "service": "payment_card_uah_hpp",
      "currency": "UAH",
      "amount": 31,
      "test_mode": false
    }
  }
}

"Still looking for help connecting your Monobank account?" Please contact our support team!