top of page

Seena API Documentation

Introduction

Our API interface is used to integrate Seena's services with client's projects. The API is designed for developers and is accompanied by detailed documentation.

Description

Seena’s REST API works over the HTTPS protocol . All answers return in the form of JSON structures.

Seena APIs

Base URL

All references to API requests in this document include the root URL: https://seenaapi.seenapay.com/sandbox/v2

Authorization

Once you have signed with Seena, you will be provided with API token (Authorization: Bearer your_token).

API token: You can authenticate with our API by providing the appropriate API token in the request Authorization header.

HTTP status code

Code 200 success    We will send it with all successful requests.

Code 400  error        We will send it with all failed requests.

API's

1. Send payment request

To send a payment request to Seena network, send a POST request to:    /add-payment-request

Request body scheme

phone  String

required

 

price  Float

required & more than 500

currency  String

required

success_callback_url

Request example

{

    "phone": "00966501208980",

    "price": "500",

     "currency":"SAR",

  "success_callback_url":"https://www.example.com/",

     "notes":"this payment request"

}

Currency Code example

- SAR

- EGP

Response example    (HTTP status code 200)

{

    "msg": "Payment Request Added Successfully",

    "status": "success",

    "code": 200,

    "data": {

        "payment_request": {

            "price": "500",

            "notes": "this payment request",

            "created_at": "2023-10-31T14:34:39.000000Z",

            "payment_link": "https://www.seenapay.com/pr/pay?token=6541107ff1a66"

        }

    }

}

Code                                 Description

200                                      Payment Request Added Successfully

400                                      Validation error Example (The phone field

                                             is required. )

2. Callback

After payment process we will send payment transaction details on your callback link

{

    "phone": "01007132399",

    "price"

{

    "operation_code":7001,

    "status_code":200,

    "status_text":"success",

    "transaction":{

         "uid":"jdskcbdkjsbkdbskcbdajc",

         "status":5,

         "doctor_uid":"djcnjadnclndanclad",

         "user_id":"jdckjbdcjkbkbckbdkcbad",

         "amount":5000

    }

}

: "500",

     "notes":"this payment request"

}

bottom of page