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
# | Name | Type | Description |
---|---|---|---|
1 | company_id | String | Company's ID |
Request Header
# | Key | Value | Description |
---|---|---|---|
1 | Authorization | Bearer {{access_token}} | Login Token |
2 | Content-Type | multipart/form-data | Form-data |
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
# | 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
# | 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.