পেমেন্ট তৈরি
টাকায় পরিমাণ দিয়ে পেমেন্টের পাতা তৈরি করুন।
POST
/v1/payment/createpayments:writeফিল্ডসমূহ
| ফিল্ড | ধরন | আবশ্যক | বিবরণ |
|---|---|---|---|
amount | number | হ্যাঁ | টাকায় পরিমাণ; দশমিকের পরে সর্বোচ্চ দুই ঘর। |
redirect_url | uri | না | পেমেন্ট শেষে ফেরত যাওয়ার প্রকাশ্য HTTPS ঠিকানা। |
webhook_url | uri | না | স্বাক্ষরযুক্ত পেমেন্টের বার্তা নেওয়ার প্রকাশ্য HTTPS ঠিকানা। |
cancel_url | uri | না | বাতিল হলে ফেরত যাওয়ার প্রকাশ্য HTTPS ঠিকানা। |
reference | string | না | নিজের অর্ডারের পরিচয়; না দিলে নিজে তৈরি হবে। |
customer_name | string | না | গ্রাহকের নাম। |
customer_email | string | না | গ্রাহকের ইমেইল ঠিকানা। |
customer_phone | string | না | যোগাযোগের নম্বর; পেমেন্টের প্রমাণ নয়। |
metadata | object | না | অর্ডারের অতিরিক্ত তথ্য; গোপন তথ্য নয়। |
amount: 150.50 মানে ৳১৫০.৫০। পরিমাণ টাকায় পাঠান, পয়সায় নয়।নিরাপদে আবার চেষ্টা
Idempotency-Key-তে ১৬–১২৮টি ইংরেজি অক্ষর, সংখ্যা, আন্ডারস্কোর, ডট, কোলন বা হাইফেন দিন। একই পেমেন্টের জন্য আবার চেষ্টা করলে একই চাবি ও তথ্য পাঠান।
অনুরোধ
curl --fail-with-body "$EKMIVO_API_ORIGIN/v1/payment/create" \
-H "Authorization: Bearer $EKMIVO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-2026-0001" \
--data '{
"amount": 150,
"redirect_url": "https://merchant.example/success"
}'প্রতিক্রিয়া
201 Created
{
"invoice_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "PENDING",
"payment_url": "https://checkout.example/checkout/TOKEN"
}শুধু
status === "COMPLETED" হলে এবং invoice_id, পরিমাণ ও মুদ্রা অর্ডারের সঙ্গে মিললে সরবরাহ করুন। শুধু HTTP 200 মানে পেমেন্ট সম্পন্ন নয়।