NAV Navbar
LoanMaster v2.8
Documentatie API-uri
shell live testing

Introducere

Această secțiune vă oferă acces la documentația completă pentru API-urile noastre publice, concepute pentru gestionarea eficientă a informațiilor asociate cu membrii (inclusiv detaliile conturilor de membru, creditele disponibile, istoricul plăților și inițierea de noi tranzacții).

Inregistrare cont nou

Inregistrarea unui client se face prin acest API. Daca toate datele sunt OK, atunci serverul returneaza un token (X-Authorization) care trebuie trimis in toate cererile prin intermediul unui header HTTP. De asemenea clientul primeste un cod de access pe email, care impreuna cu headerul X-Authorization trebuie utilizate in metoda PUT din API-ul de Autentificare.

# POST /api/external/v1/customers/register
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/register" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "company_token=some_string" \ 
      -d "first_name=some_string" \ 
      -d "last_name=some_string" \ 
      -d "cnp=some_string" \ 
      -d "mobile=some_string" \ 
      -d "email=john.doe@example.com" \ 
      -d "email_confirm=john.doe@example.com" \ 
      -d "password=random_gOoD_p@ssword!" \ 
      -d "password_confirm=random_gOoD_p@ssword!" \ 
      -d "accept_terms_and_conditions=some_string" \ 
      -d "accept_marketing=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "X-Authorization": "string. Used as X-Authorization HTTP header. Requires step-2 (via PUT method) to be activated."
    }
}

POST /api/external/v1/customers/register

Parameter Required? Type Description
company_token Yes string Se poate genera din Dashboard pe pagina /dashboard/software/api
first_name Yes string Prenumele clientului.
last_name Yes string Numele de familie al clientului.
cnp Yes cnp CNP-ul clientului.
mobile Yes phone Nr. de mobil al clientului.
email Yes email Adresa de email
email_confirm Yes email Repetare adresa de email pentru a evita greselile.
password Yes password Noua parola a contului.
password_confirm Yes password Repetati noua parola a contului.
accept_terms_and_conditions Yes boolean Acordul clientului asupra termenilor si conditiilor CAR-ului dumneavoastra.
accept_marketing Yes boolean Acordul clientului pentru abonare la newsletter.

Autentificare

Autentificarea unui client se face in doua etape.

Prima etapa: obtinerea tokenului clientului prin metoda POST. Pentru acest pas este necesar un token de companie, obtinut din Dashboard, pagina API, precum si credentialele clientului.

A doua etapa: activarea tokenului clientului se va face prin metoda PUT, utilizand tokenul generat la pasul anterior, precum si codul trimis prin EMAIL catre client.

# POST /api/external/v1/customers/auth
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/auth" \ 
      -d "company_token=some_string" \ 
      -d "email=john.doe@example.com" \ 
      -d "password=random_gOoD_p@ssword!"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "X-Authorization": "string. Used as X-Authorization HTTP header. Requires step-2 (via PUT method) to be activated."
    }
}

POST /api/external/v1/customers/auth

Parameter Required? Type Description
company_token Yes string Se poate genera din Dashboard pe pagina /dashboard/software/api
email Yes email Este adresa de email a clientului, atunci cand i s-a creat contul in aplicatie de catre personalul CAR-ului.
password Yes password Parola initiala este alcatuita din ultimele 6 cifre ale CNP-ului. Dupa prima autentificare utilizatorul trebuie sa isi schimbe parola. 
# PUT /api/external/v1/customers/auth
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/auth" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "2fa_code=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Token activated"
}

PUT /api/external/v1/customers/auth

Parameter Required? Type Description
2fa_code Yes string Codul primit de catre client prin SMS si/sau EMAIL. Este necesar pentru activarea tokenului de client, X-Authorization. 
# DELETE /api/external/v1/customers/auth
curl  -X DELETE "https://casedeajutorreciproc.ro/api/external/v1/customers/auth" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Token destroyed"
}

DELETE /api/external/v1/customers/auth

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

Resetare parola

Prin acest API un client isi poate reseta parola in cazul in care a uitat-o. Precum si in API-ul de autentificare resetarea parolei se face in doi pasi.

# POST /api/external/v1/customers/reset-password
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/reset-password" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "company_token=some_string" \ 
      -d "email=john.doe@example.com" \ 
      -d "cnp=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Reset code sent to email!"
}

POST /api/external/v1/customers/reset-password

Parameter Required? Type Description
company_token Yes string Se poate genera din Dashboard pe pagina /dashboard/software/api
email Yes email Adresa de email
cnp Yes cnp CNP-ul clientului. 
# PUT /api/external/v1/customers/reset-password
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/reset-password" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "company_token=some_string" \ 
      -d "email=john.doe@example.com" \ 
      -d "cnp=some_string" \ 
      -d "mail_code=12" \ 
      -d "password=random_gOoD_p@ssword!" \ 
      -d "password_confirm=random_gOoD_p@ssword!"

# outputs following data types: 
{
    "code": 200,
    "message": "Password changed!"
}

PUT /api/external/v1/customers/reset-password

In formularul de resetare a parolei este recomandata ascunderea campurilor de la metoda POST, si afisarea doar a campurilor noi: mail_code, password si password_confirm.

Parameter Required? Type Description
company_token Yes string Se poate genera din Dashboard pe pagina /dashboard/software/api
email Yes email Adresa de email
cnp Yes cnp CNP-ul clientului.
mail_code Yes integer Codul necesar pentru resetarea parolei.
password Yes password Noua parola a contului.
password_confirm Yes password Repetati noua parola a contului.

Setari utilizator

Prin acest API puteti modifica adresa de email/telefon asociate contului. Atentie! Daca schimbati un nr de telefon validat sau adresa de email validata, aceasta va necesita reverificarea campului modificat.

# GET /api/external/v1/customers/settings
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/settings" \ 
      -H "X-Authorization: XXXXXXX" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "first_name": "string",
        "last_name": "string",
        "email": "email",
        "phone": "phone",
        "address": "string",
        "cnp": "cnp",
        "company_public_name": "string",
        "company_legal_name": "string",
        "company_bank_iban": "string",
        "company_logo": "string",
        "company_allow_card_payment": "integer",
        "company_testing_card_pay": "integer",
        "company_address": "string",
        "company_email": "string",
        "company_phone": "string",
        "company_cui": "string"
    }
}

GET /api/external/v1/customers/settings

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

# PUT /api/external/v1/customers/settings
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/settings" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "email=john.doe@example.com" \ 
      -d "phone=some_string" \ 
      -d "address=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": []
}

PUT /api/external/v1/customers/settings

Parameter Required? Type Description
email Yes email Adresa de email
phone Yes phone Numarul de telefon/mobil.
address No string Este necesara doar daca faceti plati online sau aplicati pentru credit online.

Schimbare parola

Prin acest API puteti schimba parola contului.

# POST /api/external/v1/customers/settings/change-pass
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/settings/change-pass" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "password=random_gOoD_p@ssword!" \ 
      -d "password_confirm=random_gOoD_p@ssword!" \ 
      -d "current_password=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Data updated"
}

POST /api/external/v1/customers/settings/change-pass

Parameter Required? Type Description
password Yes password Noua parola a contului.
password_confirm Yes password Repetati noua parola a contului.
current_password Yes string Parola actuala a contului.

Verificare nr. telefon

Prin acest API puteti verifica nr. de telefon asociat contului.

# POST /api/external/v1/customers/settings/validate-phone
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/settings/validate-phone" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "phone=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "SMS code sent!"
}

POST /api/external/v1/customers/settings/validate-phone

Parameter Required? Type Description
phone Yes phone 
# PUT /api/external/v1/customers/settings/validate-phone
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/settings/validate-phone" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "phone=some_string" \ 
      -d "phone_code=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "SMS code sent!"
}

PUT /api/external/v1/customers/settings/validate-phone

Parameter Required? Type Description
phone Yes phone
phone_code Yes string

Dashboard

Apeland acest API, veți obtine informatii generice (un sumar al creditelor/fondurilor/etc) utile de afisat in dashboard/homepage al aplicatiei construite.

# GET /api/external/v1/customers/dashboard
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/dashboard" \ 
      -H "X-Authorization: XXXXXXX" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "fond_social_depus": "decimal",
        "fond_social_blocat": "decimal",
        "credite": [
            {
                "cont_membru": "string",
                "cont_credit": "string",
                "valoare_credit": "number",
                "nr_luni": "integer",
                "urmatoarea_data_scadenta": "date",
                "total_de_achitat_scadenta": "number"
            }
        ],
        "tranzactii": [
            {
                "id_tranzactie": "string",
                "tip_dispozitie": "string",
                "tip_tranzactie": "string",
                "suma_totala": "number",
                "data_operare": "date"
            }
        ]
    }
}

GET /api/external/v1/customers/dashboard

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

Conturi membru

Apeland acest API, veți vizualiza toate conturile de membru asociate persoanei autentificate.

# GET /api/external/v1/customers/accounts
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts" \ 
      -H "X-Authorization: XXXXXXX" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "cont_membru": "string",
            "nr_cerere_inscriere": "integer",
            "data_inscriere": "date",
            "data_retragere": "date",
            "este_activ": "boolean"
        }
    ]
}

GET /api/external/v1/customers/accounts

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

Bonificatii

Apeland acest API, veți vizualiza toate bonificatiile asociate unui cont de membru.

# GET /api/external/v1/customers/accounts/bonifications
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts/bonifications" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "an_bonificatie": "integer",
            "suma_bonificatie": "number",
            "suma_totala_retrasa": "number"
        }
    ]
}

GET /api/external/v1/customers/accounts/bonifications

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.

Fonduri sociale

Apeland acest API, veți vizualiza toate fondurile sociale si de deces asociate unui cont de membru.

# GET /api/external/v1/customers/accounts/funds
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts/funds" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "id_inregistrare": "string",
            "cont_credit": "string",
            "fond_social": "number",
            "fond_deces": "number",
            "cotizatie_car": "number",
            "data_operare": "date",
            "descriere": "string"
        }
    ]
}

GET /api/external/v1/customers/accounts/funds

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.

Conturi de credite

Apeland acest API, veți vizualiza toate credite asociate unui cont de membru.

# GET /api/external/v1/customers/accounts/loans
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts/loans" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "cont_membru": "string",
            "cont_credit": "string",
            "data_contract": "date",
            "dae": "number",
            "valoare_credit": "number",
            "status_credit": "string"
        }
    ]
}

GET /api/external/v1/customers/accounts/loans

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.

Detalii credite

Apeland acest API, veți vizualiza scadentarul creditului, precum si totalurile de plata.

# GET /api/external/v1/customers/accounts/loans/details
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts/loans/details" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string" \ 
      -d "cont_credit=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "summary": {
            "cont_credit": "string",
            "data_contract": "date",
            "dae": "number",
            "valoare_credit": "number",
            "nr_luni": "integer",
            "tip_rate": "string",
            "status_credit": "string",
            "total_rata_si_dobanda": "number",
            "total_penalitati": "number",
            "total_achitat_rd": "number",
            "total_rest_de_plata": "number"
        },
        "details": [
            {
                "nr_rata": "integer",
                "data_scadenta": "date",
                "rata": "number",
                "dobanda": "number",
                "total_lunar": "number",
                "penalitati": "number",
                "suma_achitata": "number",
                "rest_de_plata": "number"
            }
        ]
    }
}

GET /api/external/v1/customers/accounts/loans/details

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.
cont_credit Yes string Contul de credit care identifica in mod unic un credit la aceasta institutie.

Tranzactii

Acest API vă permite să consultați întregul istoric de tranzacții asociat cu acest cont de membru.

# GET /api/external/v1/customers/accounts/transactions
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/accounts/transactions" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "id_tranzactie": "string",
            "cont_credit": "string",
            "tip_tranzactie": "string",
            "tip_dispozitie": {
                "I": "incasare",
                "P": "plata"
            },
            "suma_totala": "number",
            "data_operare": "date",
            "suma_reprezinta": "string",
            "nr_chitanta": "integer",
            "nr_dispozitie": "integer"
        }
    ]
}

GET /api/external/v1/customers/accounts/transactions

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.

Plati online

Acest API vă permite să efectuați plăți către instituție folosind serviciul NETOPIA. După apelarea API-ului, veți primi un formular HTML, care trebuie trimis automat folosind JavaScript.

Este important să știți că instituția trebuie să aibă configurat un cont NETOPIA în panoul de control al platformei CaseDeAjutorReciproc.ro pentru a putea folosi acest API.

Payment ID - reprezinta ID-ul platii (comun cu procesatorul de plati)

Tranzaction ID - reprezinta ID-ul platii in aplicatia interna LoanMaster

# GET /api/external/v1/customers/online-payments
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/online-payments" \ 
      -H "X-Authorization: XXXXXXX" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "payment_id": "integer",
            "payment_error": "string",
            "cont_membru": "string",
            "cont_credit": "string",
            "suma_achitata": "number",
            "currency_iso": "string",
            "status_plata": "enum. with following values: unpaid | paid | canceled | credited | error | processing | unknown",
            "descriere_status": "string",
            "este_depunere_fs": "boolean",
            "created_on": "datetime",
            "tranzaction_id": "string, Apare doar dupa ce plata este procesata in graficul de credit",
            "tranzaction_processed_on": "datetime",
            "tranzaction_error": "string"
        }
    ]
}

GET /api/external/v1/customers/online-payments

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

# POST /api/external/v1/customers/online-payments
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-payments" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string" \ 
      -d "cont_credit=some_string" \ 
      -d "suma_achitata=some_string" \ 
      -d "este_depunere_fs=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "html_form": "string, which is a fully functional HTML form. It must be auto-submited using JavaScript in order to redirect user to payment page"
    }
}

POST /api/external/v1/customers/online-payments

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.
cont_credit Yes string Contul de credit care identifica in mod unic un credit la aceasta institutie.
suma_achitata Yes number Suma care se doreste a fi achitata.
este_depunere_fs No predefined_value In functie de alegerea clientului, acesta poate fie depune bani la Fondul Social, fie sa isi achite rata la credit.

Debitare directa

Acest API vă permite să activati debitarea directa a unui client pentru plata creditului.

Este important să știți că CAR-ul trebuie să aibă configurat un cont NETOPIA secundar configurat pentru debitari directe.

# POST /api/external/v1/customers/online-payments/direct-debit
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-payments/direct-debit" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "cont_membru=some_string" \ 
      -d "cont_credit=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "html_form": "string, which is a fully functional HTML form. It must be auto-submited using JavaScript in order to redirect user to payment page"
    }
}

POST /api/external/v1/customers/online-payments/direct-debit

Parameter Required? Type Description
cont_membru Yes string Contul de membru care identifica in mod unic un membru asociat la aceasta institutie.
cont_credit Yes string Contul de credit care identifica in mod unic un credit la aceasta institutie.

Status plati online

Acest API este public (nu necesita autorizare prin token) insa necesita token-ul platii pentru a-i putea vedea statusul. El este util pentru pagina in care este intors utilizatorul dupa efectuarea unei tranzactii.

# POST /api/external/v1/customers/online-payments/status
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-payments/status" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "payment_id=12" \ 
      -d "payment_hash=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "payment_id": "integer",
        "status": "enum. with following values: unpaid | paid | canceled | credited | error | processing | unknown"
    }
}

POST /api/external/v1/customers/online-payments/status

Parameter Required? Type Description
payment_id Yes integer ID-ul tranzactiei.
payment_hash Yes string Token unic asociat acestei tranzactii.

Credite online

Prin acest API un membru poate sa aplice la un credit online. Necesita abonament Diamond.

# GET /api/external/v1/customers/online-loans
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "loan_request_id": "integer",
            "loan_id": "integer",
            "denumire_credit": "string",
            "nr_luni": "integer",
            "data_solicitare": "date",
            "prima_data_scadenta": "date",
            "tip_rate": "string",
            "valoare_credit": "number",
            "urmatorul_pas": "integer",
            "status_solicitare": "string",
            "created_on": "datetime",
            "modified_on": "datetime"
        }
    ]
}

GET /api/external/v1/customers/online-loans

Parameter Required? Type Description
loan_request_id No integer ID-ul solicitarii de credit online

Tipuri de credite acordate

Acest API returneaza toate tipurile de credite online acordate de catre acest CAR.

# GET /api/external/v1/customers/online-loans/step-0-loan-types
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-0-loan-types" \ 
      -H "X-Authorization: XXXXXXX" \ 

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "product_id": "integer",
        "product_name": "string",
        "description": "string",
        "interest_contract": "number",
        "fee_fs": "number",
        "fee_granting": "number",
        "fee_analysis": "number",
        "fee_fs_is_percentage": "boolean",
        "fee_granting_is_percentage": "boolean",
        "fee_analysis_is_percentage": "boolean",
        "required_codebitors": "integer",
        "required_debitors": "integer",
        "amount_start": "integer",
        "amount_end": "integer",
        "months_start": "integer",
        "months_end": "integer"
    }
}

GET /api/external/v1/customers/online-loans/step-0-loan-types

Aceasta metoda utilizeaza doar headerul HTTP X-Authorization ca input.

1. Solicitare credit

Acest API este utilizat pentru a crea o solicitare de credit online.

# POST /api/external/v1/customers/online-loans/step-1-loan-request
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-1-loan-request" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_id=12" \ 
      -d "scop_imprumut=some_string" \ 
      -d "tip_rate=some_string" \ 
      -d "valoare_credit=some_string" \ 
      -d "nr_luni=12" \ 
      -d "data_contract=some_string" \ 
      -d "prima_data_scadenta=some_string" \ 
      -d "only_simulate=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Solicitarea de credit a fost adaugata cu success!"
}

POST /api/external/v1/customers/online-loans/step-1-loan-request

Parameter Required? Type Description
loan_id Yes integer ID-ul tipului de credit pentru care se aplica.
scop_imprumut Yes string Scopul imprumutului. De obicei se completeaza cu "nevoi personale".
tip_rate Yes predefined_values Tipul ratelor: egale | descrescatoare
valoare_credit Yes number
nr_luni Yes integer
data_contract Yes date
prima_data_scadenta Yes date
only_simulate Yes boolean Setati ca TRUE pentru simulare date si FALSE pentru salvare date. 
# PUT /api/external/v1/customers/online-loans/step-1-loan-request
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-1-loan-request" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_id=12" \ 
      -d "scop_imprumut=some_string" \ 
      -d "tip_rate=some_string" \ 
      -d "valoare_credit=some_string" \ 
      -d "nr_luni=12" \ 
      -d "data_contract=some_string" \ 
      -d "prima_data_scadenta=some_string" \ 
      -d "only_simulate=some_string" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Solicitarea de credit a fost adaugata cu success!"
}

PUT /api/external/v1/customers/online-loans/step-1-loan-request

Parameter Required? Type Description
loan_id Yes integer ID-ul tipului de credit pentru care se aplica.
scop_imprumut Yes string Scopul imprumutului. De obicei se completeaza cu "nevoi personale".
tip_rate Yes predefined_values Tipul ratelor: egale | descrescatoare
valoare_credit Yes number
nr_luni Yes integer
data_contract Yes date
prima_data_scadenta Yes date
only_simulate Yes boolean Setati ca TRUE pentru simulare date si FALSE pentru salvare date.
loan_request_id No integer ID-ul solicitarii de credit online

2. Informatii titular

Acest API este utilizat pentru a adauga informatiile despre veniturile titularului.

# GET /api/external/v1/customers/online-loans/step-2-personal-data
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-2-personal-data" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "ci_domiciliu=some_string" \ 
      -d "ci_serie=some_string" \ 
      -d "ci_numar=12" \ 
      -d "ci_eliberat_de=some_string" \ 
      -d "ci_data_eliberare=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "acord_anaf": "html, string",
        "acord_bc": "html, string"
    }
}

GET /api/external/v1/customers/online-loans/step-2-personal-data

Parameter Required? Type Description
ci_domiciliu Yes string Domiciliul titularului din cartea de identitate.
ci_serie Yes string Seria din cartea de identitate a titularului
ci_numar Yes integer Numarul din cartea de identitate a titularului
ci_eliberat_de Yes string Institutia care a eliberat cartea de identitate a titularului
ci_data_eliberare Yes date Data la care cartea de identitate a fost eliberata 
# POST /api/external/v1/customers/online-loans/step-2-personal-data
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-2-personal-data" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "este_beneficiar_real=some_string" \ 
      -d "este_pep=some_string" \ 
      -d "acord_anaf=some_string" \ 
      -d "acord_birou_credite=some_string" \ 
      -d "poza_ci_fata=some_string" \ 
      -d "poza_ci_verso=some_string" \ 
      -d "video_selfie=some_string" \ 
      -d "ci_domiciliu=some_string" \ 
      -d "ci_serie=some_string" \ 
      -d "ci_numar=12" \ 
      -d "ci_eliberat_de=some_string" \ 
      -d "ci_data_eliberare=some_string" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Solicitare credit a fost modificata cu success"
}

POST /api/external/v1/customers/online-loans/step-2-personal-data

Parameter Required? Type Description
este_beneficiar_real Yes boolean Titularul este beneficiarul real al imprumutului?
este_pep Yes boolean Titularul este persoana expusa politic (PEP)?
acord_anaf Yes boolean Titularul este de acord sa fie consultata baza de date ANAF pentru veniturile nete?
acord_birou_credite Yes boolean Titularul este de acord sa fie consultata baza de date Biroul de Credite pentru scoring?
poza_ci_fata Yes picture Poza cu CI a titularului (fata)
poza_ci_verso Yes picture Poza cu CI a titularului (spate)
video_selfie Yes video Selfie video cu titularul in timp ce mentioneaza data si ora.
ci_domiciliu Yes string Domiciliul titularului din cartea de identitate.
ci_serie Yes string Seria din cartea de identitate a titularului
ci_numar Yes integer Numarul din cartea de identitate a titularului
ci_eliberat_de Yes string Institutia care a eliberat cartea de identitate a titularului
ci_data_eliberare Yes date Data la care cartea de identitate a fost eliberata
loan_request_id No integer ID-ul solicitarii de credit online

3. Informatii venituri

Acest API este utilizat pentru identificarea video a titularului creditului.

# POST /api/external/v1/customers/online-loans/step-3-income-data
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-3-income-data" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "este_angajat=some_string" \ 
      -d "are_contract_perioada_nedeterminata=some_string" \ 
      -d "tip_pensie=some_string" \ 
      -d "este_casatorit=some_string" \ 
      -d "denumire_angajator_sau_cjp=some_string" \ 
      -d "data_angajare=some_string" \ 
      -d "angajator_judet=some_string" \ 
      -d "angajator_oras=some_string" \ 
      -d "angajator_adresa=some_string" \ 
      -d "angajator_telefon=some_string" \ 
      -d "angajator_functie=some_string" \ 
      -d "venit_net_lunar=some_string" \ 
      -d "retineri=some_string" \ 
      -d "bonuri_de_masa=some_string" \ 
      -d "nr_dosar_pensionare=some_string" \ 
      -d "extras_bancar=some_string" \ 
      -d "adeverinta_venit_sau_talon_pensie=some_string" \ 
      -d "decizia_de_pensionare=some_string" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Solicitare credit a fost modificata cu success"
}

POST /api/external/v1/customers/online-loans/step-3-income-data

Parameter Required? Type Description
este_angajat Yes boolean
are_contract_perioada_nedeterminata No boolean
tip_pensie Yes predefined_values
este_casatorit Yes boolean Starea civila a titularului.
denumire_angajator_sau_cjp Yes string
data_angajare No date
angajator_judet Yes string
angajator_oras No string
angajator_adresa No string
angajator_telefon No phone
angajator_functie No string
venit_net_lunar Yes number
retineri Yes number
bonuri_de_masa Yes number
nr_dosar_pensionare Yes string
extras_bancar Yes file
adeverinta_venit_sau_talon_pensie Yes file
decizia_de_pensionare Yes file
loan_request_id No integer ID-ul solicitarii de credit online

4. Verificare card

Acest API este utilizat pentru verificarea cardului titularului creditului.

# POST /api/external/v1/customers/online-loans/step-4-credit-card
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-4-credit-card" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "html_form": "string, which is a fully functional HTML form. It must be auto-submited using JavaScript in order to redirect user to payment page"
    }
}

POST /api/external/v1/customers/online-loans/step-4-credit-card

Parameter Required? Type Description
loan_request_id No integer ID-ul solicitarii de credit online

4. Verificare card

Acest API este utilizat pentru verificarea cardului titularului creditului.

# GET /api/external/v1/customers/online-loans/step-5-contract-sign
curl  -X GET "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-5-contract-sign" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_request_id=12"

GET /api/external/v1/customers/online-loans/step-5-contract-sign

Parameter Required? Type Description
loan_request_id No integer ID-ul solicitarii de credit online 
# POST /api/external/v1/customers/online-loans/step-5-contract-sign
curl  -X POST "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-5-contract-sign" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_request_id=12"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "message": "string, which is a fully functional HTML form. It must be auto-submited using JavaScript in order to redirect user to payment page"
    }
}

POST /api/external/v1/customers/online-loans/step-5-contract-sign

Parameter Required? Type Description
loan_request_id No integer ID-ul solicitarii de credit online 
# PUT /api/external/v1/customers/online-loans/step-5-contract-sign
curl  -X PUT "https://casedeajutorreciproc.ro/api/external/v1/customers/online-loans/step-5-contract-sign" \ 
      -H "X-Authorization: XXXXXXX" \ 
      -d "loan_request_id=12" \ 
      -d "contract_sign_pin=12" \ 
      -d "contract_signer_name=some_string"

# outputs following data types: 
{
    "code": 200,
    "message": "Success",
    "data": {
        "html_form": "string, which is a fully functional HTML form. It must be auto-submited using JavaScript in order to redirect user to payment page"
    }
}

PUT /api/external/v1/customers/online-loans/step-5-contract-sign

Parameter Required? Type Description
loan_request_id No integer ID-ul solicitarii de credit online
contract_sign_pin Yes integer Codul primit prin SMS de catre titular pentru a semna electronic creditul.
contract_signer_name Yes string Numele complet al titularului contractului

Tratarea erorilor

# A few examples of errors
                
# PUT /api/external/customers/auth may return following error
{
    "code": 403,
    "error_code": "token_missing",
    "message": "Missing token"
}
# or the next one, but not limited to
{
    "code": "403",
    "error_code": "token_banned",
    "message": "Token is banned due to more than three failed attempts"
}
# POST /api/external/customers/change-pass may return following error
{
    "code": "412",
    "data": {
        "current_password": "Parola este gresita"
    }
}

Toate codurile de raspuns primite inapoi de la API respecta standardul API RESTfull si pot fi tratate generic.

Codurile returnate de aplicatie sunt:

shell live testing