Skip to main content

Sample requests

The following is an example of an endpoint call to obtain an access token, which can then be used to make a subsequent endpoint call to create a purchase financing request.

Authentication​

Request POST​

Header: Content-Type:application/json; charset=UTF-8

Body: { "username": "testovaciusername",  "password": "test" }

use the login details for the test environment that you received after registration

Response POST​

{
  "expiresIn": 7200,
  "accessToken": "25167daf5c0d489f8b50ab685004ad5f", // used for authorization in the next request
  "tokenType": "bearer"
}

Create application​

Request POST​

Header: 
  Content-Type:application/json; charset=UTF-8 
  Authorization: bearer 25167daf5c0d489f8b50ab685004ad5f 
Body: {
    "customer": {
    "firstName": "Tom",
    "lastName": "Best",
    "email": "jan.urban@homecredit.cz",
    "phone": "+420795787720",
    "addresses": [
                      {
                        "country": "CZ",
                        "city": "Brno",
                        "streetAddress": "Holandská",
                        "streetNumber": "10",
                        "zip": "60500",
                        "addressType": "PERMANENT"
                      }
                   ],
                    "tin": "12333321",
        "vatin": "CZ8402154456"
  },
  "order": {
    "number": "578234700523",
  "variableSymbols": [
                "989595949"
            ],

    
    "totalPrice": {
      "amount": 5200000,
      "currency": "CZK"
    },
    "totalVat": [
      {
        "amount": 210000,
        "currency": "CZK",
        "vatRate": 21
      }
    ],
    "addresses": [
      {
        "country": "CZ",
        "city": "Brno",
        "streetAddress": "Holandská",
        "streetNumber": "22",
        "zip": "60500",
        "addressType": "DELIVERY"
      }
    ],
    
   
    "items": [
      {
                "code": "97878",
                "ean": "9999545",
        "name": "iPhone 6s 32GB SpaceGray",
        "quantity": 1,
        "unitPrice": {
          "amount": 999500,
          "currency": "CZK"
        },
        "unitVat": {
          "amount": 210000,
          "currency": "CZK",
          "vatRate": 21
        },
        "totalPrice": {
          "amount": 999500,
          "currency": "CZK"
        },
        "totalVat": {
          "amount": 210000,
          "currency": "CZK",
          "vatRate": 21
        },
        "productUrl": "https://www.example.com?itemId=10"
       

      }
    ]
  },
  "type": "INSTALLMENT",
  "settingsInstallment": {
    "preferredMonths": 10,
     "preferredInstallment": {
      "amount": 0,
      "currency": "CZK"
    },
    "preferredDownPayment": {
      "amount": 0,
      "currency": "CZK"
    },
    "productCode": "",
    "productSetCode": "MIXHCONL"
  },
  "sentDate": "2017-01-10",
  "agreementPersonalDataProcessing": true,
  "merchantUrls": {
    "approvedRedirect": "http://localhost9",
    "rejectedRedirect": "http://localhost",
    "notificationEndpoint": "http://uzjepekne.cz"
  }
}

SK version of the query​

Header: 
  Content-Type:application/json; charset=UTF-8 
  Authorization: bearer 25167daf5c0d489f8b50ab685004ad5f 
Body: { 
    "customer": {    
    "firstName": "Honza",    
    "lastName": "Bohaty",    
    "email": "jan.bohaty@homecredit.sk",    
    "phone": "+421795587720",    
    "addresses": [                      
      {                        
        "country": "SK",                        
        "city": "Piešťany",                        
        "streetAddress": "Teplická",                        
        "streetNumber": "147",                        
        "zip": "92122",                        
        "addressType": "PERMANENT"                      
      }                   
    ],                    
    "tin": "12333321",        
    "vatin": "SK8402154456"
  },  
	"order": {    
    "number": "9786661967",  
    "variableSymbols": [                
      "989495949"            
    ],      
  	"totalPrice": {      
      "amount": 240000,      
      "currency": "EUR"    
    },    
    "totalVat": [      
      {        
        "amount": 36000,        
        "currency": "EUR",        
        "vatRate": 15      
      }    
    ],    
  	"addresses": [      
      {        
        "country": "SK",        
        "city": "Piešťany",        
        "streetAddress": "Teplická",        
        "streetNumber": "147",        
        "zip": "92122",        
        "addressType": "BILLING"      
      }    
    ],       
    "items": [      
      {        
        "code": "97878",        
        "ean": "9999545",        
        "name": "iPhone 6s 32GB SpaceGray",        
        "quantity": 2,        
        "unitPrice": {          
          "amount": 120000,          
          "currency": "EUR"        
        },        
        "unitVat": {          
          "amount": 18000,          
          "currency": "EUR",          
          "vatRate": 15        
        },        
        "totalPrice": {          
          "amount": 240000,          
          "currency": "EUR"        
        },        
        "totalVat": {          
          "amount": 36000,          
          "currency": "EUR",          
          "vatRate": 15        
        },        
        "productUrl": "https://www.example.com?itemId=10"      
      }    
    ]  
  },  
  "type": "INSTALLMENT",  
  "settingsInstallment": {    
    "preferredMonths": 24,    
    "preferredDownPayment": {      
      "amount": 50000,      
      "currency": "CZK"    
    },    
    "productCode": "COCONL24",    
    "productSetCode": "COCHCONL"      
  },  
  "sentDate": "2017-01-10",  
  "merchantUrls": {    
  "approvedRedirect": "http://localhost9",    
  "rejectedRedirect": "http://localhost",    
  "notificationEndpoint": "http://tunotifikovat.sk"  }
}

At the end of the response, there is an attribute with information about the gateway to which the client needs to be redirected. It may look like this:

{ 
…
"gatewayRedirectUrl": https://myloan.cz40a1.hciapp.net/entry;uuid=d3eddf91-08f9-43cd-a1ae-3222005ec43b 
…
}

After being redirected, the client will be taken to the first window of the MyLoan HC application, where they will complete the steps necessary for the purchase/loan to be approved.