Ezeebill

Your trusted Payment Service Provider with nearly 10 years of experience in the Pan-Asian online

Supports in this guide: Payments, Payouts

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

Get your credentials (from Ezeebill)
Connect in Dashboard
Send an API request

Prerequisites: get from Ezeebill

Send a request on ezeebillasia.com or contact your Ezeebill account manager directly to get your account verified and receive the following credentials.

Merchant ID -> Corefy field merchant_id.
Terminal ID -> Corefy field terminal_id.
Access ID -> Corefy field access_id.
Operator ID -> Corefy field operator_id.
Password -> Corefy field password.
Secure hash -> Corefy field secure_hash.
Currency -> Corefy field currency -> choose from the currencies available for your account.
Pay type (optional) -> Corefy field pay_type -> Bank Transfer, Internet Banking, or China Union -> used directly for Payouts; for Payments the pay type is instead selected per route via the service you call.

One Provider account is used for both Payments and Payouts.

Note

If you need to whitelist IPs on Ezeebill's side, ask your account manager and provide Corefy's IP list from the integration docs.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Ezeebill in the provider directory and press Connect at Ezeebill Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

Merchant ID
Terminal ID
Access ID
Operator ID
Password
Secure hash
Currency
Pay type (optional)
Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Ezeebill Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to Ezeebill's hosted checkout. Bank transfer (JPY, INR, IDR, MYR, THB, VND) and China UnionPay (CNY) are supported, selected via service.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4304-8a12-7c8d9e0f1a2b",
      "service": "bank_transfer_jpy_hpp",
      "currency": "JPY",
      "amount": 1000
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8b9c0d1e-2f30-4415-8b23-8d9e0f1a2b3c",
      "service": "bank_transfer_jpy_hpp",
      "currency": "JPY",
      "amount": 1000,
      "customer": {
        "name": "Taro Yamada",
        "email": "test@example.com",
        "phone": "+81312345678",
        "address": {
          "street": "1 Chiyoda",
          "city": "Tokyo",
          "post_code": "100-0001",
          "country": "JP"
        }
      }
    }
  }
}

Important

If customer.name, .email, .phone, or .address fields are missing, Ezeebill still receives a request - Corefy fills the gaps with placeholder values (for example a placeholder email and a Hong Kong address) rather than failing the request. Send real customer data whenever you have it to avoid this.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Refunds

Ezeebill does not support refunds.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Uses the same Provider account connected above - no separate connection step.

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds to a bank account via Ezeebill's bank transfer network. IDR, MYR, THB, VND, JPY, and INR are supported.

Payout - MIN

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "9c0d1e2f-3041-4526-8c34-9e0f1a2b3c4d",
      "service": "bank_transfer_jpy",
      "currency": "JPY",
      "amount": 1000,
      "fields": {
        "account_number": "1234567",
        "account_name": "Taro Yamada",
        "bank_code": "0001",
        "bank_name": "Example Bank",
        "bank_branch": "Main Branch",
        "bank_branch_code": "001"
      }
    }
  }
}

Important

fields.account_number, .account_name, .bank_code, .bank_name, .bank_branch, and .bank_branch_code identify the recipient bank account; which of these are actually required depends on the destination country/bank.

Payout - MAX

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0d1e2f30-4152-4637-8d45-0f1a2b3c4d5e",
      "service": "bank_transfer_jpy",
      "currency": "JPY",
      "amount": 1000,
      "fields": {
        "account_number": "1234567",
        "account_name": "Taro Yamada",
        "bank_code": "0001",
        "bank_name": "Example Bank",
        "bank_branch": "Main Branch",
        "bank_branch_code": "001",
        "beneficiary_full_name": "Taro Yamada",
        "beneficiary_state": "Tokyo",
        "beneficiary_city": "Tokyo"
      }
    }
  }
}

No Options or Constants are configured for Payouts.

Additional info

Active reconciliation is available - both Payments and Payouts support an active status request.
No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

Invalid credentials / auth error -> verify Merchant ID, Terminal ID, Access ID, Operator ID, Password and Secure hash for the selected environment (test_mode)
Payment reaches Ezeebill with unexpected placeholder customer data -> send real customer.name/.email/.phone/.address - missing fields are filled with placeholders rather than rejected
Currency or service is not supported -> confirm allowed currencies/pay types in your Ezeebill account and in Corefy
Refund fails -> Ezeebill does not support refunds through Corefy

Question

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