README

Bank up your business

FitBank provides comprehensive financial service integrations. With a RESTful API platform, FitBank allows businesses to build custom products adapted to customers' needs.

Fully configurable, ideal for instant payments with PIX, boleto collection, utilities and taxes payments, online balance and statement, digital onboarding, and prepaid card in a white-label experience and beyond.

Why FitBank?

We aspire to speed up the digital transformation of the entire financial ecosystem with scale, performance, and control of high-volume transactions.

This library provides developers with a simple set of bindings to help you integrate Fitbank API to PHP website project.

Fitbank Dev Portal

Hi, Dev! This page will help you get started with FitBank API. https://dev.fitbank.com.br/docs

💡 Requirements

PHP 7.3 or higher

🧩 Fitbank Collections

✅ = All methods available ⌛ = Under development/testing 💻 = Awaiting contributions

📦 Installation

First time using Fitbank? Create your Fitbank account, if you don’t have one already.

Download Composer if not already installed
On your project directory run on the command line composer require "hafael/fitbank-php-sdk"
Copy the API Key and Secret and replace API_KEY and API_SECRET with it.

That's it! Fitbank PHP SDK has been successfully installed.

🌟 Getting Started

Simple usage looks like:

  <?php
    require_once 'vendor/autoload.php'; // You have to require the library from your Composer vendor folder

    $fitbankClient = new Hafael\Fitbank\Client(
        'API_KEY', 
        'API_SECRET', 
        'PARTNER_ID', 
        'BUSINESS_UNIT_ID',
        'MKTPLACE_ID',
        'TAX_NUMBER', //Account Owner
        'BASE_URL', //Sandbox as default
    );

    //Get created accounts
    $response = $fitbankClient->account()->getAccountList();
    var_dump($response->json());

  ?>

Creating new KYC Account

  <?php
    require_once 'vendor/autoload.php';

    use Hafael\Fitbank\Client;
    use Hafael\Fitbank\Models\Account;
    use Hafael\Fitbank\Models\Address;
    use Hafael\Fitbank\Models\Document;
    use Hafael\Fitbank\Models\Person;

    ...

    //Create new KYC Account
    
    $holder = new Person([
        'personRoleType' => Person::ROLE_TYPE_HOLDER,
        'taxNumber' => '88494940090',
        'identityDocument' => '269435310',
        'personName' => 'Rafael de Marquez Santos',
        'nickname' => 'Rafael',
        'mail' => 'rafaelmail@meuemail.com',
        'phoneNumber' => '219729345534',
        'checkPendingTransfers' => false,
        'publicExposedPerson' => false,
        'birthDate' => '1996/05/20',
        'motherFullName' => 'Daniela Cruz de Marquez',
        'fatherFullName' => 'João Francisco Santos',
        'nationality' => 'Brasileiro',
        'birthCity' => 'Niterói',
        'birthState' => 'Rio de Janeiro',
        'gender' => Person::GENDER_MALE,
        'maritalStatus' => Person::MARITAL_SINGLE,
        'occupation' => 'Empresário',
    ]);

    $documents = [
        Document::fromBase64('dGVzdGU=', Document::FORMAT_JPG)
                ->documentType(Document::TYPE_CNH)
                ->expirationDate('2023/04/15'),
        Document::fromBase64('dGVzdGU=', Document::FORMAT_JPG)
                ->documentType(Document::TYPE_PROOF_ADDRESS),
    ];

    $addresses = [
        new Address([
            'addressType' => Address::RESIDENTIAL,
            'addressLine' => 'Av. Constantino de Barros Filho',
            'addressLine2' => '61',
            'complement' => 'APT 704',
            'zipCode' => '24360-022',
            'neighborhood' => 'São Francisco',
            'cityName' => 'Niterói',
            'state' => 'RJ',
            'country' => 'Brasil',
        ])
    ];

    $account = new Account([
        'holder' => $holder,
        'documents' => $documents,
        'addresses' => $addresses,
    ]);

    $response = $fitbankClient->account->newAccount($account);
    var_dump($response->json());


  ?>

hafael / fitbank-php-sdk

Maintainers

Details