transbank-fi

    1.2.1 • Public • Published

    tbk_node

    NPM

    Transbank node.js module (NOT OFFICIAL)

    Install

    npm install transbank
    

    Config

    If you want to test your transbank implementation, just use the configuration provided by this plugin :

    var tbk               = require('transbank');
    ...
    var tbkConfig         = tbk.config;
    var TBKObject         = new tbk.TBK(tbkConfig);
    

    This way you will end up with a full working Transbank object, where, through its functions, you can manage all your webpay transactions.

    To put your custom credentials, once you are ready to production, overwrite the config object :

    COMMERCE_CODE   : 597020000541, 					  //TBK sample commerce code
    ENVIRONMENT     : 'INTEGRACION',						//TBK debug mode as default
    PRIVATE_KEY     : __dirname + '/certs/private_test_cert.pem',
    PUBLIC_KEY      : __dirname + '/certs/public_test_cert.pem',
    WEBPAY_KEY      : __dirname + '/certs/webpay_test_cert.pem'
    

    Also, you can fill those fields using environment variables :

    export TBK_COMMERCE_CODE=597020000541
    export TBK_ENVIRONMENT=INTEGRACION
    export TBK_PRIVATE_KEY=certs/private_test_cert.pem
    export TBK_PUBLIC_KEY=certs/public_test_cert.pem
    export TBK_WEBPAY_KEY=certs/webpay_test_cert.pem
    

    Methods

    To execute any of this methods the TBK object must be initialized. It's not guaranteed to be ready right after you make a new instance of it, so create it at your server start up, or any other place you have to init all main modules of your application. Also, you don't have to create a new TBK object with every new transaction, just reuse the same object you created at the beggining. THe constructor just initializes the soap client with credentials supplied in the config object or env variables.

    initTransaction

    TBK.initTransaction(amount, buyOrder, sessionId, returnURL, finalURL, callback)
    

    WebPay initTransaction, where callback is a function that receives error and result params. If the signature of transbank's response doesn't match with WebPay's certificate, it will come as an error for the callback function too. This applies for any method.

    getTransactionResult

    Once you receive the init transaction response, you can call this method using the token included in that response.

    TBK.getTransactionResult(token, callback)
    

    The callback, again, is a function that receives error and result params, in the result param you will find a JSON object with all buyer's data, check transbank documentation for more details about it (the XML response from transbank's servers is automatically transformed into json).

    acknowledgeTransaction

    If the payment is accepted, call this method with the token you got from transaction result :

    TBK.acknowledgeTransaction(token, callback)
    

    Remember then redirect the user to 'urlRedirection', field you can find in the JSON obtained through getTransactionResult.

    THIS IS NOT AN OFFICIAL PLUGIN FROM TRANSBANK!

    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    Licenced using LGPL.

    Install

    npm i transbank-fi

    DownloadsWeekly Downloads

    0

    Version

    1.2.1

    License

    LGPL-3.0

    Unpacked Size

    41 kB

    Total Files

    13

    Last publish

    Collaborators

    • acalvoa