# EKANNTO Pay API Guide (প্রাথমিক)

## Payment intent তৈরি
Endpoint: `POST https://YOUR_PROJECT_REF.supabase.co/functions/v1/create-payment-intent`

Headers:
- `Authorization: Bearer USER_ACCESS_TOKEN`
- `apikey: SUPABASE_ANON_KEY`
- `Content-Type: application/json`

Body:
```json
{
  "amount_minor": 125000,
  "currency": "BDT",
  "order_id": "ORDER-2026-001",
  "idempotency_key": "unique-order-attempt-001",
  "description": "Order payment"
}
```
`amount_minor` হলো ক্ষুদ্রতম currency unit (BDT-এর ক্ষেত্রে পয়সা)। 125000 = ৳1,250.00।

Response `pending_provider_setup` হতে পারে। এর অর্থ payment request record তৈরি হয়েছে, টাকা নেওয়া হয়নি। Provider integration না থাকলে paid হবে না।

## Status check
`GET https://YOUR_PROJECT_REF.supabase.co/functions/v1/payment-status?id=PAYMENT_UUID`
একই Authorization এবং apikey headers ব্যবহার করুন।

## Production merchant integration
Production merchant API-তে customer-facing website থেকে সরাসরি user access token ব্যবহার করা উচিত নয়। Merchant secret API key, request signing, rate limiting, idempotency, webhook delivery/retry, signature verification এবং reconciliation সহ dedicated server-to-server API layer তৈরি করতে হবে। এই starter-এ API key storage schema আছে, কিন্তু পূর্ণ merchant-key issuance/rotation এবং provider-specific webhook verification এখনো configure করা হয়নি।