Getting Started

This guide walks you through integrating Kashia into your platform — from creating a merchant account to receiving your first webhook notification.

Step 1: Create a Kashia Merchant Account

• Sign up at kashiahq.com/get-started
• Complete business verification
• Get approved by the Kashia team

Step 2: Get Your API Keys

• Go to Dashboard → Integrations
• Copy your API key
• Your API key is used for all server-to-server API calls

Step 3: Create a Customer

Before creating a payment link, register the buyer (and seller for marketplaces) as a customer. See Customers for details.

curl -X POST https://api.kashiahq.com/api/v1/external/customers \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "buyer@example.com",
    "first_name": "John",
    "last_name": "Doe"
  }'

Step 4: Create a Payment Link

Create a payment link with the customer ID from step 3. Amounts are in the smallest currency unit (kobo for NGN).

curl -X POST https://api.kashiahq.com/api/v1/external/payment-links \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "buyer_user_id": "uuid-from-step-3",
    "title": "iPhone 15 Pro",
    "amount": 150000000,
    "currency": "NGN"
  }'

Step 5: Redirect to Payment

• Redirect the buyer to the payment_url returned in step 4
• The buyer pays on Kashia's hosted payment page
• Kashia handles the escrow automatically after payment

Step 6: Listen for Webhooks

• Set up a webhook URL in Dashboard → Integrations
• Kashia sends events when escrow status changes
• Verify webhook signatures using your webhook secret — see Webhooks

Complete Integration Flow

Your App → Create Customer → Create Payment Link → Redirect Buyer → Buyer Pays
  → Escrow Created → Delivery → Confirmation → Funds Released → Webhook Notification