PUMB (FUIB)

Supports in this guide: Payments, Payouts

Provider website: pumb.ua

What you need to do for start processing transactions (brief summary)

1. Choose account type
2. Get your credentials (from PUMB)
3. Connect in Dashboard
4. Send an API request

Choose account type

PUMB (FUIB) can be connected in different ways (depending on your needs):

• If you do direct card payments (H2H, no redirect) -> choose H2H Merchant account
• If you do card payouts -> choose Provider account

If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from PUMB (FUIB)

Contact your PUMB relationship/account manager (via the bank's business portal) to get your merchant account verified and receive the following credentials. Which fields you actually need depends on the Account type you pick inside the H2H Merchant account form (see below).

• Merchant ID -> Corefy field merchant_id -> used for the Acquiring account type
• Account ID -> Corefy field account_id -> used for the Acquiring account type
• Merchant Config ID -> Corefy field merchant_config_id -> used for the InternetAcquiring (Apple Pay) account type
• User login -> Corefy field user_login (H2H Merchant account) / login (Provider account) -> used for every account type
• User password -> Corefy field user_password
• Base URL -> Corefy field base_url -> used for the Acquiring account type only
• Portal ID -> Corefy field portal -> used for the Acquiring account type only

PUMB (FUIB) processes in UAH only.

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8afec793-9b41-4dc4-b281-c76cc54ffb89",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123"
      }
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "06fa1ea9-8a5b-4dbc-b67b-6236b3b9af3d",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "individual_tax_id": "1234567890"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "eae08d28-1a7a-407f-ab4d-2c8275ca7964",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 50,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "58acf793-9b41-4dc4-b281-c76cc54ff230",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 50,
      "customer": {
        "reference_id": "cus_123"
      },
      "fields": {
        "card_number": "4111111111111111",
        "card_holder": "John Doe"
      }
    }
  }
}

Additional info

1. Active reconciliation only, no callbacks - PUMB (FUIB) does not send asynchronous callbacks on either flow. Payments status is resolved via the 3D Secure return/completion step plus active status requests; Payouts status is resolved via active statement requests.

2. No recurring - this connector does not support saving or charging a token through Corefy.

3. Apple Pay is supported on Payments, available through the C2A and InternetAcquiring account types, with token decryption handled by Corefy.

   For more information, visit:

   • How to Integrate Apple Pay with Corefy: Full Technical Walkthrough

4. Payments amount limits: 0.01 - 1,000,000 UAH per transaction.

5. No Options or Constants are configured for this connector.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify the User login/password (and, for Acquiring, the Merchant ID/Account ID/Base URL/Portal ID) for the selected environment (test_mode)
• Payment fails only on C2A -> make sure the request includes a customer object, and that the H2H Merchant account's Merchant Profile (Website URL, Company name, IBAN) is filled in Dashboard
• Payout rejected with invalid details -> fill in the Merchant Profile (Website URL, Company name, IBAN, Country, City, Address) in Dashboard before sending payouts
• Refund fails -> only one refund per payment is allowed, and it requires the original transaction ID
• Not sure which account type to use? -> ask your Corefy account manager