bookmebus / spree_vpago

Spree extension for traditional redirect off site payment gateway in Cambodia
BSD 3-Clause "New" or "Revised" License
0 stars 0 forks source link

SpreeVpago

Introduction goes here.

Installation

  1. Add this extension to your Gemfile with this line:

    gem 'spree_vpago', github: '[your-github-handle]/spree_vpago'
  2. Install the gem using Bundler

    bundle install
  3. Copy & run migrations

    bundle exec rails g spree_vpago:install
  4. Restart your server

    If your server was running, restart it so that it can find the assets properly.

Testing

First bundle your dependencies, then run rake. rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using rake test_app.

bundle
bundle exec rake

When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:

require 'spree_vpago/factories'

Run test

rspec spec/

Required Variables

Acleda

For mobile

    ENV['ACLEDA_MOBILE_SECRET_HASH_KEY']

For desktop

    ENV['ACLEDA_CHECK_STATUS_PATH']
    ENV['ACLEDA_CREATE_SESSION_PATH']

Payment method configuration:

Icon Name: acleda

Payway

ENV configuration:

ENV['PAYWAY_CHECKOUT_PATH']
ENV['PAYWAY_CHECK_TRANSACTION_PATH']
ENV['PAYWAY_RETURN_CALLBACK_URL']
ENV['PAYWAY_CONTINUE_SUCCESS_CALLBACK_URL']

Payment method configuration:

HOST: https://checkout-sandbox.payway.com.kh
Payment Option: one of the [abapay, cards]
Merchant: vtenh
Api Key: xxxxx
Icon Name: one of the [payway_abapay, payway_cards]

Note

Most payment gateways are written in php, you might compare ruby with its php counterpart by running code in the .php file.

Handle missing info

Some payment gateway require email for payment info. So we use enviroment variable "DEFAULT_EMAIL_FOR_PAYMENT" as default email when there is no email provided.

Contributing

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

Copyright (c) 2021 [name of extension creator], released under the New BSD License