Yedpay

Description (Upload File to Company Entity)

Action to upload files which relate to company. (POST)

End Point

https://api.yedpay.com/v1/companies/{{company_id}}/documents

Variable

Variable
# Name Type Description
1 company_id String Company's ID

Request Header

Request Header
# Key Value Description
1 Authorization Bearer {{access_token}} Login Token
2 Content-Type multipart/form-data Form-data

Body

Body
# Name Type Description
1 file File Select the desired file
2 type String The type of file (Type "store_br" is for admin ONLY)
3 shared Boolean Share file or not
4 br_number String Business Registration number (for type='br' or 'store_br' only, optional)
5 branch_number Numeric String Branch number of the company (for type='br' or 'store_br' only, optional, default: 000)
6 expiry_date Date Expiry Date of the BR (for type='br' or 'store_br' only, optional), format: YYYY-mm-dd
7 store_id String Store ID of the Store BR (for type = 'store_br' only)
8 ci_number String Number of the CI (for type = "ci" only)
9 company_name String Company name displayed in the CI (for type = "ci" only)
10 date_of_establishment String CI's date of establishment (format: YYYY-MM-DD)(for type = "ci" only)
11 contract_type Integer Type of the contract
(Required when type = "yedpay_contract")

Response

Response
# Name Type Description
1 success Boolean Upload File Success or Fail
2 data Array Include File's Information (id, user_id, type, etc..)

Success Response - data

Success Response - data
# Name Type Description
1 id String Id of the File
2 user_id String Id of the User
3 type String Type of the File
4 name String Name of the File
5 description String Description of the File
6 mime String MIME Type of the File
7 size Integer Size of the File
8 shared Boolean Whether the File is Shared or Not (true/false)
9 br_number String Business Registration number (for type=​"br" or "store_br" only)
10 branch_number Numeric String Branch number of the BR (for type="br" or "store_br" only)
11 registered_company_name String Company name displayed in the BR (for "br" type file only)
12 type_of_business Integer Type of business registered via the BR (for "br" type file only)
13 expiry_date String Expiry Date of the BR (format: yyyy-MM-dd) (for type="br" or "store_br" only)
14 ci_number String Number of the CI (for last "ci" type file only)
15 ir_number String Number of the IR (for last "ir" type file only)
16 company_name String Company name displayed in the CI/IR (for last "ci" / "ir" type file only)
17 date_of_establishment String CI's date of establishment (format: yyyy-MM-dd) (for last "ci" type file only)

Example Success Response

            //normal data
            {
                "success": true,
                "data": {
                    "id": "7VEXG3O841DKY4PD0N",
                    "user_id": "6PEQD4O4GW2Z5VY8W3",
                    "uploader_id": "6YEXR4KEGE4Z3N8QG5",
                    "fileable_type": "App\Models\Company",
                    "fileable_id": "3PG7YQKYR2NZDXJRVE",
                    "type": "logo",
                    "name": "xxxxxxxxxxxx",
                    "description": "xxxxxxxxxxxxx",
                    "mime": "xxxxxxx",
                    "size": 781,
                    "shared": false,
                    "updated_at": 2024-03-19 19:10:07
                }
            }

            //BR data
            {
                "success": true,
                "data": {
                    "id": "58YN319ZPQKX2DJ7PE",
                    "user_id": "2NMJVPOMPX9O70RL8W",
                    "uploader_id": "MJ86QYO3N4NOEP3RG5",
                    "fileable_type": "App\Models\Company",
                    "fileable_id": "Q1N07LOJJW6O35P2GD",
                    "type": "br",
                    "name": "xxxxxxxxxxxx",
                    "description": "xxxxxxxxxxxxx",
                    "mime": "xxxxxxx",
                    "size": 781,
                    "shared": false,
                    "updated_at": 2024-03-19 19:10:07​,
                    "registered_company_name": "xxxxxxxxx",
                    "type_of_business": 4,
                    "br_number": "14785990",
                    "branch_number": "006",
                    "expiry_date": "2024-03-19"
                }
            }

            //CI data
            {
                "success": true,
                "data": {
                    "id": "7E52LGO2EQVZ68YJDQ",
                    "user_id": "3590G4Z0QNDZ76QXV8",
                    "uploader_id": "7E52LGO2P4JO68YJDQ",
                    "fileable_type": "App\Models\Company",
                    "fileable_id": "9302L8KRV1MOEPRYJ7",
                    "type": "ci",
                    "name": "xxxxxxxxxxxx",
                    "description": "xxxxxxxxxxxxx",
                    "mime": "xxxxxxx",
                    "size": 781,
                    "shared": false,
                    "updated_at": 2024-03-19 19:10:07,
                    "ci_number": "15169987",
                    "company_name": "xxxxxxxxxxxx",
                    "date_of_establishment": "2024-03-19"
                }
            }


Example Error Response

            {
                "success": false,
                "message": "Unauthenticated.",
                "status": 500
            }
        

Available Contract Type

# Type Description
0 other_agreement Other Agreement
1 offline_gateway_agreement Offline Gateway Agreement
2 online_gateway_agreement Online Gateway Agreement

v1.65.0-20240318 © The Payment Cards Group Limited. All rights reserved.