Content

To start receiving payments, you need to create at least one product and then create and assign billing models to it. The billing models reflect the payment types displayed to your customers. There are 3 default billing models each of which can be configured differently to define how the payment is made and to suit your business needs:

– Single PullPayment
– Subscription PullPayment
– Single + Subscription PullPayment

Once the billing model is set up, the QR code and button snippets will be generated, so that it can be placed on your resource to be displayed for the customers. 

In order to retrieve the list of all transactions on a specific network, or by transaction status through the API call (for example, via your custom developed application) you will need to use following call to our backend server:

api/v2/api-key-auth/transactions/all/{businessID}?page={page}&itemsPerPage={itemsPerPage}

For more info and call details, please refer to our API documentation

The next step once you have created a product is to set up billing models under it to start accepting payments from your customers. 

5.1. Creating a New Billing Model

Step 1

There are the 3 main billing model variations each configurable for payment type reflection:

  • Single PullPayment (Example: One-time payment of $5.00) A Single PullPayment accepts one-time payment 
  • Subscription PullPayment (Example: Monthly subscription of $12.99) Initializes the recurring subscription and has 1 additional option to enable the trial period, so you can charge a fixed amount at a predefined interval.
  • Single + Subscription PullPayment (Example: Single payment for 3-day trial and then monthly subscription) Single payment followed by a recurring payment.

Step 2 The next step will allow you to choose from one of the 4 supported local currencies and will be used as the base reference currency familiar to your customers:

  • USD (US Dollars)
  • EUR (Euro)
  • GBP (Great Britain Pound)
  • JPY (Japanese Yen)

The cost will be reflected in PMA tokens based on the exchange rate with the selected base currency.

Once your payment model is created, you are provided with the details overview, gas fee estimation for the transaction and QR code generated with an embed link, different style variations of the buttons which you can embed on your website to be displayed to the customers.

After you review the billing model and are sure that everything is set correctly, you can proceed to publishing your model. This means your billing model will be stored in the list with all of your models in the database connected to the PumaPay Server (the server-side technology behind the Business Console).

Step 3 Specifying the amount and the base currency the customer has to pay in PMA equivalent.

Example of a Single PullPayment billing model details

Both, the recurring and single+recurring billing models, have a trial on/off switch to enable the trial period for the service. 

Step 4 In this step you are informed about how much gas each transaction will cost :

5.2. Billing model overview

The overview of a billing model shows the overall details you have defined and the preview, as the customer will see it once he scans the QR code. The QR code is generated and can be embedded either as a snippet or as a button, and then it can be scanned by the customer with the PumaPay Mobile Wallet App. 

Each generated billing model will display the gas fee estimations that are expected to be paid once the PullPayment is executed.

n order to retrieve the list of the billing models through the API call (for example, via your custom developed application) you will need to use following call to our backend server:

api/v2/api-key-auth/pull-payment-models

For more info and call details, please refer to our API documentation

Was this article helpful to you?

Leave a Reply