Krijo llogari bankare (v1)

POST /api/v1/on-boarding/bank-account Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Krijoni nje llogari bankare per kompanine. Llogaria bankare shfaqet ne faturat elektronike dhe jo-cash si informacion pagese per klientin.

Full URL: https://fature.al/api/v1/on-boarding/bank-account

Body parameters

Name	Type	Required	Description
name	string, nullable	no	Emri i bankes, ai qe shfaqet ne fature krahas IBAN-it.
holder	string, nullable	no	Mbajtesi i llogarise, zakonisht emri i kompanise.
iban	string, nullable	no	IBAN-i i llogarise, ai qe shfaqet ne fature qe klienti te paguaje.
swift	string, nullable	no	Kodi SWIFT/BIC i bankes, i nevojshem per pagesa nga jashte.
currency	string, nullable	no	Monedha e llogarise. Nje llogari mban nje monedhe te vetme.
notes	string, nullable	no	Shenime qe shoqerojne llogarine ne fature.

Responses

200 Kur ruajtja e llogarise deshton, pergjigja kthehet me HTTP 200 dhe `status: false`.

201 Created

Field	Type	Description
status	boolean
data	object
data.bankAccount	object
data.bankAccount.id	integer
data.bankAccount.iban	string

422 Te dhenat nuk kaluan validimin. Kjo pergjigje perdor fushen `success`, jo `status`.

Field	Type	Description
success	boolean	Always false
message	string	A single summary line, the same for every validation failure
errors	object	The failing fields, each with the messages for it. Dotted keys point into nested objects and array items, e.g. `lines.0.quantity`

Example request

cURL

curl -X POST 'https://fature.al/api/v1/on-boarding/bank-account' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "BKT",
    "holder": "Ei3 Software Solution shpk",
    "iban": "AL35202111090000000001234567",
    "swift": "NCBAALTX",
    "currency": "ALL",
    "notes": "notes"
}'

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
])->post('https://fature.al/api/v1/on-boarding/bank-account', [
    'name' => 'BKT',
    'holder' => 'Ei3 Software Solution shpk',
    'iban' => 'AL35202111090000000001234567',
    'swift' => 'NCBAALTX',
    'currency' => 'ALL',
    'notes' => 'notes',
]);

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://fature.al/api/v1/on-boarding/bank-account', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'name' => 'BKT',
        'holder' => 'Ei3 Software Solution shpk',
        'iban' => 'AL35202111090000000001234567',
        'swift' => 'NCBAALTX',
        'currency' => 'ALL',
        'notes' => 'notes',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

JavaScript

const response = await fetch('https://fature.al/api/v1/on-boarding/bank-account', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "name": "BKT",
      "holder": "Ei3 Software Solution shpk",
      "iban": "AL35202111090000000001234567",
      "swift": "NCBAALTX",
      "currency": "ALL",
      "notes": "notes"
  })
});

const data = await response.json();

Example response

201

{
    "status": true,
    "data": {
        "bankAccount": {
            "id": 1,
            "iban": "iban"
        }
    }
}

422

{
    "success": true,
    "message": "Hello there",
    "errors": []
}