op-sdk v2.1.1

Steps to use our service

1) Contact onepiece.payment@gmail.com to set up an account 2) Once your account is set up, login to your Admin Console account at https://admin.one-piece.us 3) Create a new pirate_token in the console 4) You may now use the available methods below and start using our service with the pirate_token

Option 1: Utilizing the npm op-sdk

How does op-sdk work

This package is publicly available for anyone to install. However, you will need to sign up an account with One-Piece in order to be able to use our service. With this sdk and your One-Piece account, you will be able to get available payment methods, get the list of acceptable price list, initate payments and check status of a specific transaction.

How to start

• Run npm install op-sdk --save to install the latest npm package.

Instantiate an Opsdk instance

//javascript

import OPSdk from 'op-sdk';

let newMerchant = new OPSdk(pirate_token, pirate_key) //The "pirate_token" and "pirate_key" can be found in the Admin Console

Available methods from this sdk

Request parameters

OPSdk (for op-sdk constructor)

Initiate Payment (options)

Get Payment Status (payment_token)

Example for express app

In order to use the op-sdk in your node app, you will need to require and setup in desired route.

  ...
  //op-sdk required
  const OPSdk = require('op-sdk');
  ...
  
  //create new Opsdk instance with required constructor
  let newMerchant = new Opsdk(pirate_token, pirate_key) //The "pirate_token" and "pirate_key" can be retrieved from Admin Console

  //sample route to get available payment methods
  router.get('/methods', async (req, res) => {

      const getAvailableMethods = await newMerchant.findPaymentMethods();
      const availableMethods = getAvailableMethods.payload.methods;

      //Logging response data
      console.log(availableMethods);
      res.render('index', { title: "Available Methods", data: availableMethods })
  })

  //sample route to get acceptable price list
  router.get('/price', async (req, res) => {

      const getAcceptablePriceList = await newMerchant.findAvailablePriceList();
      const priceList = getAcceptablePriceList.payload.prices;
      
      //Logging response data
      console.log(priceList);
      res.render('index', { title: "Available Prices", data: priceList })
  })
  
  //sample route to initiate payment
  router.get('/checkout', async (req, res) => {

      const amount = (parseFloat(amount) *100).toFixed(0); //￥1 will need to be converted to 100, ￥100 will need to be converted to 10000
      const notify_url = http://yourcompany/notify/wechat //example
      const return_url = http://yourcompany/pay/success //example

      const options = {
            'amount': amount
            'payment_method': 'wechatpay', //payment_method must be spelled exactly as: 'wechatpay', 'alipay' or 'qqpay'
            'notify_url': notify_url,
            'return_url': return_url,
            'order_num': '123456789', //optional
            'browser_ip_address': 'provideCustomerIP', //optional
            'browser_mac_address': 'provideCustomerMacAddress', //optional
      };

      const newTransaction = await newMerchant.initPayment(options);

      //Redirect to our QR code page. Once payment has been recevied, the system will automatically redirect to the provided "return_url"
      res.redirect(newTransaction.qrcodeURL)
  });
  
  //sample route to get payment status
  router.get('/status', async (req, res) => {

      const gotStatus = await newMerchant.checkPaymentStatus(payment_token);
      res.render('index', { title: "Got Payment Status", data: [gotStatus.status, gotStatus.payload.payment_status.message });
  });

  module.exports = router;

Option 2: Make direct calls to our system

1) Get available payment methods from our system

Description: This function will be used when the user needs to get the list of available payment methods. It takes in the pirate_token as a parameter. Our system will respond with an array of payment methods the user can use. URL: https://api.one-piece.us/payment/methods/availability/{pirate_token}/{magic_num}/{signature} Method: GET

2) Get acceptable price list

Description: This function will be used when the user needs to get the list of acceptable price. Our system will respond with an array of available price list. URL: https://api.one-piece.us/payment/prices/{pirate_token}/{magic_num}/{signature} Method: GET

3) Initiate payment

Description: This function will be used to initiate a payment transaction. It takes in an object called options as a request body (See options requirements below). Once the transaction is initiated properly, our system will generate a transaction and respond with a paymentToken as well as a link to the QR Code. Once payment has been received, the system will automatically redirect to the provided "return_url". The user will be able to view the transaction details in the Admin Console. URL: https://api.one-piece.us/payment/ Method: POST Body: {options}

4) Get payment status

Description: When the payment has been recieved or updated, Our system will make a POST call to the provided "notify_url" with the payment status. In the event when the user wants to check the transaction status, this call can be used to get the status of the specific transaction. The call takes in the payment_token as a parameter and will return with a status. User will be able to view the trasaction details in the Admin Console. URL: https://api.one-piece.us/payment/status/{pirate_token}/{payment_token}/{magic_num}/{signature} Method: GET

Reference

Admin Console: https://admin.one-piece.us React Demo: http://demo.one-piece.us/ Demo Repo: https://github.com/onepiece-payment/react-demo Questions: onepiece.payment@gmail.com