Create Payment Intent

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Your Frontend  │────▶│  Your Backend   │────▶│   Khaime API    │
│                 │     │                 │     │                 │
│  Checkout Form  │     │  POST /checkout │     │  POST /payment  │
│  + Customer     │     │  (your route)   │     │  /intent        │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                                                        │
                                                        ▼
                              ┌─────────────────────────────────────┐
                              │  Returns token with gateway config  │
                              │  (gateway selected automatically)   │
                              └─────────────────────────────────────┘
                                                        │
                                                        ▼
                        ┌─────────────────────────────────────────────┐
                        │  <KhaimeCheckout token={token} />           │
                        │  Renders correct payment UI automatically   │
                        └─────────────────────────────────────────────┘

curl -X POST https://api.khaime.com/api/v1/payment/intent \
  -H "X-API-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_amount": 5000,
    "charge_currency": "USD",
    "merchant_amount": 5000,
    "merchant_currency": "USD",
    "description": "Order #123",
    "customer": {
      "email": "jane@example.com",
      "first_name": "Jane",
      "last_name": "Doe"
    }
  }'

{
  "status": true,
  "message": "Payment charge created successfully",
  "data": {
    "token": "eyJtZXJjaGFudF9pZCI6MTc5MCwicGF5bWVudF9nYXRld2F5Ijoic3RyaXBlIi...",
    "charge_id": "intent_abc123-def456-789",
    "amount": 5000,
    "currency": "USD",
    "status": "pending",
    "mode": "live",
    "breakdown": {
      "subtotal": 5000,
      "total": 5000,
      "customer_pays_fees": false,
      "is_international": false
    },
    "expires_at": "2024-01-15T10:30:00.000Z"
  }
}

import { KhaimeCheckout } from '@khaime/react';

function CheckoutPage({ token }) {
  return (
    <KhaimeCheckout
      token={token}
      onSuccess={(result) => {
        console.log('Payment successful!', result);
        window.location.href = '/success';
      }}
      onError={(error) => {
        console.error('Payment failed:', error);
      }}
      onClose={() => {
        console.log('Checkout closed');
      }}
    />
  );
}

import 'package:khaime_flutter/khaime_flutter.dart';

KhaimeCheckout(
  token: token,
  onSuccess: (result) {
    print('Payment successful: $result');
  },
  onError: (error) {
    print('Payment failed: $error');
  },
  onClose: () {
    print('Checkout closed');
  },
);

{
  "status": true,
  "message": "Payment charge created successfully",
  "data": {
    "token": "eyJtZXJjaGFudF9pZCI6MTc5MCwi...",
    "charge_id": "intent_abc123-def456-789",
    "amount": 5320,
    "currency": "USD",
    "status": "pending",
    "mode": "live",
    "breakdown": {
      "subtotal": 5000,
      "transaction_fee": 320,
      "total": 5320,
      "customer_pays_fees": true,
      "is_international": false
    },
    "expires_at": "2024-01-15T10:30:00.000Z"
  }
}

const { amount, currency, breakdown } = intent.data;
const money = (minor) =>
  new Intl.NumberFormat(undefined, { style: "currency", currency }).format(minor / 100);

const lines = [{ label: "Subtotal", value: money(breakdown.subtotal) }];
if (breakdown.customer_pays_fees && breakdown.transaction_fee > 0) {
  lines.push({ label: "Transaction fee", value: money(breakdown.transaction_fee) });
}
lines.push({ label: "Total", value: money(amount) });

// After getting the response
window.location.href = response.data.payment_url;

curl -X POST https://api.khaime.com/api/v1/payment/intent \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_amount": 5000,
    "charge_currency": "USD",
    "merchant_amount": 5000,
    "merchant_currency": "USD",
    "description": "Order #123",
    "reference": "order_123",
    "callback_url": "https://yourstore.com/order-complete",
    "customer": {
      "email": "customer@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "country": "US"
    }
  }'

# Step 1: Get converted amount
# GET /pricing/calculate?amount=9000&source_currency=USD&target_currency=NGN
# Response: { "converted_amount": 1440000, "rate": 1600 }

# Step 2: Create payment intent with both amounts
curl -X POST https://api.khaime.com/api/v1/payment/intent \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_amount": 1440000,
    "charge_currency": "NGN",
    "merchant_amount": 9000,
    "merchant_currency": "USD",
    "description": "Design consultation",
    "customer": {
      "email": "client@example.ng",
      "first_name": "Emeka",
      "last_name": "Eze",
      "country": "NG"
    }
  }'

curl -X POST https://api.khaime.com/api/v1/payment/intent \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "preview": true,
    "charge_amount": 5000,
    "charge_currency": "USD",
    "merchant_amount": 5000,
    "merchant_currency": "USD",
    "customer": {
      "email": "customer@example.com"
    }
  }'

{
  "status": true,
  "message": "Preview calculated",
  "data": {
    "preview": true,
    "amount": 5320,
    "currency": "USD",
    "breakdown": {
      "subtotal": 5000,
      "transaction_fee": 320,
      "total": 5320,
      "customer_pays_fees": true,
      "is_international": false
    }
  }
}

// app/api/checkout/route.ts
import { NextResponse } from 'next/server';

const KHAIME_API_KEY = process.env.KHAIME_API_KEY!;
const KHAIME_API_URL = 'https://api.khaime.com/api/v1';

export async function POST(request: Request) {
  const { amount, currency, customer, orderId } = await request.json();

  const response = await fetch(`${KHAIME_API_URL}/payment/intent`, {
    method: 'POST',
    headers: {
      'X-API-Key': KHAIME_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      // Customer pays this amount in this currency
      charge_amount: amount,
      charge_currency: currency,
      // Merchant receives this amount in this currency
      merchant_amount: amount,
      merchant_currency: currency,
      description: `Order #${orderId}`,
      reference: `order_${orderId}`,
      callback_url: `${process.env.NEXT_PUBLIC_URL}/order/${orderId}`,
      customer,
    }),
  });

  const data = await response.json();

  if (!data.status) {
    return NextResponse.json({ error: data.message }, { status: 400 });
  }

  // Return only the token to the frontend
  return NextResponse.json({
    token: data.data.token,
    amount: data.data.amount,
    currency: data.data.currency,
  });
}