Aldy Pay
  1. Transaction
Aldy Pay
  • Vendors
    • Auth
      • Login With Password
      • Login Get Code
      • Login With Code
      • Send OTP
    • Transaction
      • Assets
        GET
      • Transactions
        POST
      • Invoice
        POST
      • Refund
        POST
  1. Transaction

Transactions

POST
/api/v1/vendors/{vendor}/transactions

Validation Data (Status Code: 422)#

در صورتی که دیتاهایی که نیاز به اعتبارسنجی دارند، نتواند اعتبار سنجی رو پاس کنند متن خطای مربوط به همان اعتبار سنجی در یک آرایه برگردانه میشود.
مثال:
"data": {
    "code": [
      "code انتخاب شده، معتبر نیست"
    ]
  }

Invalid Data (Status Code: 422)#

در صورتی که درخواست به دلیل خطاهای منطقی یا نقص در اطلاعات ورودی قابل پردازش نباشد، یکی از پیام‌های زیر بازگردانده می‌شود:
پیام خطاتوضیح
اعتبار شما کافی نمی‌باشدکاربر موجودی کافی برای انجام تراکنش ندارد.
کارت مورد نظر غیر فعال می‌باشدکارت انتخابی در حال حاضر فعال نیست.
مدت اعتبار رمز یکبار مصرف به پایان رسیده استزمان استفاده از رمز یکبار مصرف (OTP) منقضی شده است.
در خرید اینترنتی تنها رمز یکبار مصرف معتبر می‌باشدبرای تراکنش‌های اینترنتی تنها رمز پویا پذیرفته می‌شود.
رمز عبور صحیح نمی‌باشدرمز وارد شده نادرست است.
کارت مورد نظر مجاز خرید در این شعبه نمی‌باشدکارت انتخابی اجازه‌ی انجام تراکنش در این پذیرنده یا شعبه را ندارد.

Internal Server Error (Status Code: 500)#

در صورت بروز خطای داخلی در سرور، پیام زیر بازگردانده می‌شود:
پیام خطاتوضیح
لطفاً مجدداً تلاش کنیدخطای داخلی سرور رخ داده است. لطفاً درخواست خود را بعداً تکرار کنید.

توضیحات:
تمامی پیام‌های خطا به‌صورت متنی و با فرمت JSON در پاسخ سرور بازگردانده می‌شوند.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠422Validation Error
🔴500Internal Server Error
🟠422Invalid Data
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://devbo.aldypay.com/api/v1/vendors/aldypay/transactions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "card code",
    "password": "889744",
    "amount": "1",
    "store_code": "WHM-1-1",
    "order_items": [
        {
            "barcode": "123234234",
            "name": "test",
            "qty": 12,
            "price": 12345
        },
        {
            "barcode": "123234234",
            "name": "test",
            "qty": 12,
            "price": 12345
        }
    ]
}'
Response Response Example
200 - Success
{
    "status": true,
    "code": 200,
    "description": "OK",
    "data": {
        "transaction_number": "019a0149-ed92-7094-b6cd-737ba6b92adf"
    }
}
Modified at 2025-10-26 10:11:42
Previous
Assets
Next
Invoice
Built with