Device Finance Prebooking

This services checks feasibility for devices finance


Parameters

Name In Type Required Description
orgId path string true Organization name as it is registered in Mas-Stack
entityBank query array[string] false Desired financial entity to be consulted (Currently only XCF is supported)
body body finance_required_info true ‘none’

Request body - JsonObject

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "personal_details": {
    "personal_data": {
      "document_id": {
        "type": "NIF",
        "value": "11111111A",
        "expiration_date": "YYYY-MM-DD"
      },
      "name": "Lorenzo",
      "surnames": [
        "Muñoz",
        "Medina"
      ],
      "birthdate": "YYYY-MM-DD",
      "gender": 1,
      "nationality": "ES"
    },
    "contact_data": {
      "email": "example@example.com",
      "phone_number": "6XXXXXXXX",
      "phone_number2": "6XXXXXXXX"
    },
    "employment": {
      "profession": 8,
      "company": "Mycompany S.A.",
      "income": "1900,00 / 1900.00",
      "income_source": 1,
      "other_income_source": "Otra fuente",
      "activity_country": "ES",
      "professional_area": 1,
      "professional_use": false
    },
    "segment": "string",
    "address": {
      "street": "Ejemplo",
      "street_type": "Calle",
      "number": "2",
      "bis": "string",
      "city": "Madrid",
      "gescal": "28XXXXXXXXXXXXXXX",
      "district": "string",
      "block": "string",
      "stair": "string",
      "floor": "string",
      "letter": "string",
      "zip_code": "28001",
      "province": "Madrid",
      "state": "string",
      "country": "ES",
      "additional_details": "string"
    }
  },
  "order_details": {
    "sfid": "string",
    "fuc_code": 323841452,
    "telco_society": 1,
    "order_type": 0,
    "device": {
      "id": "string",
      "brand": "Apple",
      "model": "Iphone 13 256 Gb",
      "name": "Apple Iphone 13 256 Gb",
      "description": "string",
      "category": 1,
      "colour": "black",
      "value": "1199,00 / 1199.00"
    }
  },
  "financial_details": {
    "financial_brand": 1,
    "financial_product": 1,
    "final_payment": "100,00 / 100.00",
    "loan": {
      "value": 119,
      "commision": 0,
      "tae": 0,
      "tin": 0,
      "duration": 0,
      "monthly_fee": 0,
      "bank_account": {
        "name": "Lorenzo",
        "surnames": [
          "Muñoz",
          "Medina"
        ],
        "iban": "string"
      }
    }
  }
}
Name Type Required Description
personal_details personal_details false none
order_details order_details false none
financial_details financial_details false none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

curl -X POST https://feasibility.sta.masstack.com/v1/orgs/masmovil/finance/devices/feasible?entityBank=["XCF"] \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'personal_details': {
    'personal_data': {
      'document_id': {
        'type': 'NIF',
        'value': '11111111A',
        'expiration_date': 'YYYY-MM-DD'
      },
      'name': 'Lorenzo',
      'surnames': [
        'Muñoz',
        'Medina'
      ],
      'birthdate': 'YYYY-MM-DD',
      'gender': 1,
      'nationality': 'ES'
    },
    'contact_data': {
      'email': 'example@example.com',
      'phone_number': '6XXXXXXXX',
      'phone_number2': '6XXXXXXXX'
    },
    'employment': {
      'profession': 8,
      'company': 'Mycompany S.A.',
      'income': '1900,00 / 1900.00',
      'income_source': 1,
      'other_income_source': 'Otra fuente',
      'activity_country': 'ES',
      'professional_area': 1,
      'professional_use': false
    },
    'segment': 'string',
    'address': {
      'street': 'Ejemplo',
      'street_type': 'Calle',
      'number': '2',
      'bis': 'string',
      'city': 'Madrid',
      'gescal': '28XXXXXXXXXXXXXXX',
      'district': 'string',
      'block': 'string',
      'stair': 'string',
      'floor': 'string',
      'letter': 'string',
      'zip_code': '28001',
      'province': 'Madrid',
      'state': 'string',
      'country': 'ES',
      'additional_details': 'string'
    }
  },
  'order_details': {
    'sfid': 'string',
    'fuc_code': 323841452,
    'telco_society': 1,
    'order_type': 0,
    'device': {
      'id': 'string',
      'brand': 'Apple',
      'model': 'Iphone 13 256 Gb',
      'name': 'Apple Iphone 13 256 Gb',
      'description': 'string',
      'category': 1,
      'colour': 'black',
      'value': '1199,00 / 1199.00'
    }
  },
  'financial_details': {
    'financial_brand': 1,
    'financial_product': 1,
    'final_payment': '100,00 / 100.00',
    'loan': {
      'value': 119,
      'commision': 0,
      'tae': 0,
      'tin': 0,
      'duration': 0,
      'monthly_fee': 0,
      'bank_account': {
        'name': 'Lorenzo',
        'surnames': [
          'Muñoz',
          'Medina'
        ],
        'iban': 'string'
      }
    }
  }
}" 

Responses

Code Meaning Description Schema
200 OK Success finance_response
400 Bad Request Bad request bad_request_finance_response
404 Not Found Not found not_found_response
default Default Error error_response

Endpoints

Coverage

    Coverage management

      Blacklist Contact Data

        Map

          Connection installation

            Portability

              Device Finance Prebooking

                Subscription Limit

                  Sales Documents

                    Pole Info

                      Finance Renewal