Provider Setup Guides

G

Grow.il — Simple Redirect

No API credentials needed. Use your existing Grow payment page URL and receive webhooks.

No API needed Redirect

✓

Best for: Simple websites that just need to redirect customers to a payment page and get notified when payment completes.

What you need

Your Grow.il payment page URL from the Grow dashboard

How it works

You redirect customers to your Grow payment page. Grow notifies your server via webhook when payment completes.

1

Get your payment page URL

Log in to your Grow.il dashboard. Go to Payment Pages and copy the URL of your payment page (e.g. https://secure.meshulam.co.il/pay/your-page-code).

2

Configure webhook URL in Grow dashboard

In your Grow payment page settings, set the notification URL to your webhook endpoint. We recommend including a secret for security:

Webhook Configuration

Set these URLs in your Grow payment page settings:

Notification URL (webhook): https://yoursite.co.il/api/webhook?bizup_secret=YOUR_SECRET
Success URL: https://yoursite.co.il/thank-you
Failure URL: https://yoursite.co.il/checkout?error=true

3

Redirect customers to your payment page

On your checkout page, redirect the customer to your Grow payment page URL.

checkout.ts

// Simple redirect — no SDK needed for this part
const GROW_PAGE_URL = 'https://secure.meshulam.co.il/pay/your-page-code'

// On checkout button click:
window.location.href = GROW_PAGE_URL

4

Handle the webhook

Install @bizup-pay/core and @bizup-pay/grow to parse Grow's webhook into a clean, typed object.

webhook.ts

import { createProvider, verifyWebhookSecret } from '@bizup-pay/core'
import '@bizup-pay/grow'

const WEBHOOK_SECRET = process.env.WEBHOOK_SECRET!

// You still need Grow API credentials to parse webhooks
const pay = createProvider('grow', {
  pageCode: process.env.GROW_PAGE_CODE!,
  userId: process.env.GROW_USER_ID!,
})

export async function POST(req: Request) {
  // Verify the secret in the URL
  if (!verifyWebhookSecret(req.url, WEBHOOK_SECRET)) {
    return new Response('Unauthorized', { status: 401 })
  }

  const event = await pay.parseWebhook(await req.json())

  if (event.type === 'payment.completed') {
    const tx = event.transaction
    // tx.amount, tx.status, tx.customer
    await fulfillOrder(tx)
  }

  return Response.json({ received: true })
}

ℹ

Note: Even in simple mode, you need pageCode and userId from Grow to parse webhooks and query transactions. You can find these in your Grow dashboard under API settings.

G

Grow.il — Full API

Dynamic payment sessions with customer pre-fill, custom amounts, and transaction management.

Full API Redirect

What you need

pageCode and userId from Grow dashboard → API Settings

Auth method

Form-based params sent with each request. No tokens or headers.

Sandbox

Base URL: sandbox.meshulam.co.il

Production

Base URL: secure.meshulam.co.il

1

Install packages

npm install @bizup-pay/core @bizup-pay/grow

2

Get credentials from Grow dashboard

Go to API Settings and copy your pageCode and userId.

3

Create provider and start accepting payments

checkout.ts

import { createProvider, buildWebhookUrl } from '@bizup-pay/core'
import '@bizup-pay/grow'

const pay = createProvider('grow', {
  pageCode: process.env.GROW_PAGE_CODE!,
  userId: process.env.GROW_USER_ID!,
})

const session = await pay.createSession({
  amount: 149.90,
  currency: 'ILS',
  description: 'Premium Plan',
  customer: { name: 'Israel Israeli', email: 'israel@example.com' },
  successUrl: 'https://yoursite.co.il/thank-you',
  webhookUrl: buildWebhookUrl('https://yoursite.co.il/api/webhook', 'your-secret'),
})

// Redirect customer to payment page
// session.pageUrl → https://secure.meshulam.co.il/pay/...

C

Cardcom

Full-featured credit card processing with Low Profile pages, installments, and document generation.

Full API Redirect Iframe

What you need

terminalNumber, apiName, and apiPassword from Cardcom dashboard

Auth method

Credentials sent in every request body. No tokens or sessions.

Sandbox

Terminal 1000 is a public sandbox. Get API name/password from Cardcom.

Features

Installments, recurring payments, tokenization, tax invoices, receipts

1

Install packages

npm install @bizup-pay/core @bizup-pay/cardcom

2

Get credentials from Cardcom

Sign up at cardcom.solutions and get your terminal number, API name, and API password.

checkout.ts

import { createProvider, buildWebhookUrl } from '@bizup-pay/core'
import '@bizup-pay/cardcom'

const pay = createProvider('cardcom', {
  terminalNumber: 1000,  // sandbox terminal
  apiName: process.env.CARDCOM_API_NAME!,
  apiPassword: process.env.CARDCOM_API_PASSWORD!,
})

const session = await pay.createSession({
  amount: 100,
  currency: 'ILS',
  description: 'Order #1234',
  customer: { name: 'Israel Israeli', email: 'israel@example.com' },
  successUrl: 'https://yoursite.co.il/thank-you',
  webhookUrl: buildWebhookUrl('https://yoursite.co.il/api/webhook', 'your-secret'),
})

// session.pageUrl → Cardcom Low Profile payment page

Webhook Setup

Cardcom sends webhooks to the webhookUrl provided in createSession(). No dashboard configuration needed — the URL is set per-transaction.

M

Morning (Green Invoice)

Payments with built-in invoice and receipt generation. Popular for businesses that need accounting integration.

Full API Redirect Iframe

What you need

apiKey and apiSecret from Green Invoice dashboard → Settings → API Keys

Auth method

Bearer token: Authorization: Bearer key:secret

Sandbox

Register at sandbox.greeninvoice.co.il

Features

Automatic invoices/receipts, customer management, document downloads

1

Install packages

npm install @bizup-pay/core @bizup-pay/morning

2

Get API credentials

In your Green Invoice account, go to Settings → API Keys and generate a new API key pair.

checkout.ts

import { createProvider, buildWebhookUrl } from '@bizup-pay/core'
import '@bizup-pay/morning'

const pay = createProvider('morning', {
  apiKey: process.env.MORNING_API_KEY!,
  apiSecret: process.env.MORNING_API_SECRET!,
})

const session = await pay.createSession({
  amount: 79.90,
  currency: 'ILS',
  description: 'T-Shirt',
  customer: { name: 'Israel Israeli', email: 'israel@example.com' },
  successUrl: 'https://yoursite.co.il/thank-you',
  webhookUrl: buildWebhookUrl('https://yoursite.co.il/api/webhook', 'your-secret'),
  language: 'he',  // Hebrew payment page
})

// session.pageUrl → Morning hosted payment page
// After payment: tx.documentUrl → Invoice/receipt PDF

i

iCount

Accounting platform with integrated payment processing. Session-based authentication with automatic renewal.

Full API Redirect

What you need

cid (company ID), paypageId, and either accessToken or user/pass from iCount

Auth method

Session ID (SID) — auto-managed, cached for 19 minutes, refreshes automatically

Two auth options

Recommended: accessToken (bearer token)
Alternative: user + pass

Features

Invoice-receipt generation, PDF download URLs, recurring payments

⚠

Recommended: Use accessToken auth for production. The user/pass mode sends credentials in the HTTP request body — avoid this if possible.

1

Install packages

npm install @bizup-pay/core @bizup-pay/icount

2

Get credentials from iCount

Get your company ID, pay page ID, and API token from your iCount account settings.

checkout.ts

import { createProvider, buildWebhookUrl } from '@bizup-pay/core'
import '@bizup-pay/icount'

// Option A: Access token (recommended)
const pay = createProvider('icount', {
  cid: process.env.ICOUNT_CID!,
  paypageId: 2,
  accessToken: process.env.ICOUNT_TOKEN!,
})

// Option B: Username/password
// const pay = createProvider('icount', {
//   cid: 'your-cid', paypageId: 2,
//   user: 'your-user', pass: 'your-pass',
// })

const session = await pay.createSession({
  amount: 200,
  currency: 'ILS',
  description: 'Consulting Service',
  customer: { name: 'Israel Israeli', email: 'israel@example.com' },
  successUrl: 'https://yoursite.co.il/thank-you',
  webhookUrl: buildWebhookUrl('https://yoursite.co.il/api/webhook', 'your-secret'),
})

// session.pageUrl → iCount payment page
// After payment: tx.documentUrl → Invoice-receipt PDF

Webhook Setup (IPN)

iCount uses IPN (Instant Payment Notification). The webhook URL is set per-transaction via webhookUrl in createSession(). You may also need to enable IPN in your iCount account settings.