صفحه مستندات برگشت

• تمام درخواست های خود را از طریق پروتکل https ارسال کنید.
• ما تمام درخواست های خود را از طریق پروتکل https ارسال می کنیم.
• کاراکترست استفاده شده utf-8 است.
• تمام درخواست ها از به فرمت json ارسال و دریافت می شوند.

قدم اول (دریافت کد درگاه):

ابتدا از طریق لینک زیر در سایت ثبت نام کرده و ازطریق پنل کاربری وبسایت خود را تایید کنید و سپس ‍ کلید درگاه پرداخت خود در یافت کنید.

لینک ثبت نام در سایت: https://gateway.chatsift.com/auth/register

فرمت کلی کلید درگاه پرداخت: abcd1234-abcd-1234-abcd-1234abcd1234

قدم دوم (دریافت کد پرداخت):

شما ابتدا نیاز به یک کلید authority نیاز دارید. برای دریافت این کلید یک درخواست برای پلتفرم بفرستید.

نوع درخواست: POST

آدرس درخواست (URL ): https://gateway.chatsift.com/payment/paymentRequest

پارامتر های درخواست:

نکته مهم: در تمام مثال های ما برخی از پارامترهای head در خواست برای سادگی حذف شده اند.

یک نمونه در خواست:

POST /v3/oauth/request HTTP/1.1POST /v3/oauth/request HTTP/1.1
Host: https://gateway.chatsift.com/payment/paymentRequest
Content-Type: application/json; charset=UTF-8
X-Accept: application/json

{ 
        "amount"     : 24.5,
        "callbackURL": "https://your-domain.com/callback",
        "gatewayKey" : "abcd1234-abcd-1234-abcd-1234abcd1234"
}

یک نمونه پاسخ:

HTTP/1.1 200 OK
Content-Type: application/json
Status: 200 OK

{ 
    "authority" : "dcba4321-dcba-4321-dcba-4321dc",
    "status"    :  200
}

 توکنی که در این قسمت دریافت می کنید(authority) را در مکانی ذخیره کنید زیرا در مراحل بعدی به آن نیاز پیدا می کنید.

اگر همه چیز موفقیت آمیز باشد، status پاسخ شما 200 است اما در صورتی که هرگونه خطایی اتفاق بیوفتد، می توانید جزئیات خطایی که اتفاق افتاده است را از طریق ۳ فیلد 1,2,3 ‌که در هدر سایت قرار دارند، بررسی کنید:

POST /v3/oauth/request HTTP/1.1
    Host: https://gateway.chatsift.com/payment/paymentRequest
    Content-Type: application/json; charset=UTF-8
    X-Accept: application/json

    { 
        "gatewayKey" :  "abcd1234-abcd-1234-abcd-1234abcd1234",
        "authority"  :  "authority-format"
    }

HTTP/1.1 200 OK
    Content-Type: application/json
    Status: 200 OK

    { 
        "status" : 200
    }