Skip to content

Latest commit

 

History

History
235 lines (154 loc) · 4.25 KB

README.md

File metadata and controls

235 lines (154 loc) · 4.25 KB

sync-net

Overview

-- This is a lightweight Paybook SDK for .NET, wich allows you to consume Paybook methods.

Prerequisites

-- Visual Studio 2012 or above
-- Microsoft .NET Framework 4.5 or above

Downloading from Github

-- Open in Visual Studio
-- Create a new web or webapi project
-- Download Paybook.dll from this site which is contained into lib folder
-- Create a folder called "lib" in your main project folder
-- Paste Paybook.dll into lib folder
-- Go back to Visual Studio
-- Right click on References
-- On contextual menu select the option "Add Reference..." 
-- Click on "Browse" button, in find Paybook.dll
-- Click on "Add" button
-- Click on "OK" button
-- You will see on References a Paybook.dll added

Downloading from Nuget Gallery

-- Open in Visual Studio
-- Create a new web or webapi project
-- Right click on References
-- On contextual menu select the option "Manage Nuget Packages..." 
-- Under browser Option type on search text box "Paybook", press enter.
-- You will see on the list Paybook v1.0.0 select it and on right panel click on Install button
-- In preview window click on "OK" Button
-- In order to verify the correct installation expand References and you will see Paybook.dll added

Signup

Register a new user to Paybook
  • Method

    string signup(string username)

    Required:

    username=[string]

  • Success Response:

    id_user=[string]

  • Error Response:

    Exception=[Exception]

  • Sample Call:

    Paybook paybook = new Paybook();
    string id_user = paybook.signup("some username");
    

Login

Login an exisiting user

  • Method:

    string login(string id_user)

    Required:

    id_user=[string]

  • Success Response:

    token=[string]

  • Error Response:

    Exception=[Exception]

  • Sample Call:

    Paybook paybook = new Paybook();
    token = paybook.login("some id_user");
    

Catalogs

Retrieve the set of institutions available

  • Method:

    string catalogs(string token)

    Required:

    token=[string]

  • Success Response:

    response=[string] Note: this response is a JSON Object

  • Error Response:

    Exception=[Exception]

  • Sample Call:

     Paybook paybook = new Paybook();
     token = paybook.login("some id_user");
    

Credentials

Register credentials for a specific institution

  • Method:

    JObject credentials(JObject newcredentials)

    Required:

    newcredentials=[JObject]

  • Success Response:

    response=[JObject] Note: this response is a JSON Object

  • Error Response:

    Exception=[Exception]

  • Sample Call:

     Paybook paybook = new Paybook();
     JObject credentials = new JObject();
     JObject new_credentials = paybook.credentials(credentials);
    

Status

Get the sync status of a specific institution

  • Method:

    string status(string token, string id_site, string url_status)

    Required:

    token=[string] id_site=[string] url_status=[string]

  • Success Response:

    response=[string] Note: this response is a JSON Object

  • Error Response:

    Exception=[Exception]

  • Sample Call:

     Paybook paybook = new Paybook();
     status = paybook.status("some token", "some id_site", "some url_status");
    

Accounts

Get the accounts registered in a specific institution

  • Method:

    string accounts(string token, string id_site)

    Required:

    token=[string] id_site=[string]

  • Success Response:

    response=[string] Note: this response is a JSON Object

  • Error Response:

    Exception=[Exception]

  • Sample Call:

     Paybook paybook = new Paybook();
     accounts = paybook.accounts("some token", "some id_site");
    

Transactions

Get the accounts registered in a specific account

  • Method:

    string transactions(string token, string id_account)

    Required:

    token=[string] id_account=[string]

  • Success Response:

    response=[string] Note: this response is a JSON Object

  • Error Response:

    Exception=[Exception]

  • Sample Call:

     Paybook paybook = new Paybook();
     transactions = paybook.transactions("some token", "some id_account");