Inline Integration

1. Inline Integration

Add AtaraPay inline javascript and css files to your page

• <link rel="stylesheet" href="https://plugins.atarapay.com/assets/test/trustpay.inline.min.css">
• <script src="https://plugins.atarapay.com/assets/test/trustpay.inline.min.js"></script>

Add the following to your html body

<form id="trustpay-form">
    <button id="ataraPayButton" type="button" style="">
</form>

Note: The Button is not styled. Style the Button to fit.

Add Functionality to the Button

var payWithTrustpay = function () {
    my-api-key = 'my-public-key'
    merchant = new Merchant({api_key:my-public-key});
            handler = TrustPay.setup(merchant);
            handler.initialize(customer_email, customer_phone_number, {
                type : 1,
                currency: NGN or USD,
                amount: order_price,
                amount_fx: order_price_in_USD,
                customer_firstname: first_name,
                customer_lastname: last_name,
                order_product_id: product_id, 
                order_product_name: product_name,
                order_product_desc: product_description,
                "order_product_weight": order_product_weight,
                "order_product_quantity": order_product_quantity,
                "order_product_dimension": order_product_dimension,
                "product_type": "product_type",
                recipient: order_recipient,
                delivery_date: order_delivery_date,
                delivery_location: order_delivery_location,
                is_marketplace: 0,
                seller_phone: null,
                sp_id: sp_id,
                sp_commission: sp_commission,
                callback_url: success_redirection_URL
            });
}

Field name	Required	Description
currency	Yes	Transaction Currency (NGN or USD)
amount	Yes	Amount in kobo
amount_fx	Yes	Amount converted to USD (required if currency is USD)
customer_firstname	Yes	Customer's First name
customer_lastname	Yes	Customer's Last name
order_product_id	Yes	The seller's product ID
order_product_name	Yes	The seller's product name
order_product_desc	Optional	The seller's product Description
order_product_dimension	Yes	Product dimension of the item. The format is Lenght x Width x Height in centimeters (cm). Note that AtaraPay only supports one item type in the cart.
product_type	No	Product type value should be ‘physical’ or ‘service’. A physical product is one that is shippable and has weight and dimensions like a pair of shoes. A service is one that is not shippable and doesn’t have weight and dimension like website development.
order_product_weight	No	Product weight of the item in kilograms (kg)
delivery_date	Yes	The seller's delivery date
delivery_location	Yes	The customer's delivery location
recipient	Yes	The phone number of the customer
type	Yes	Transaction type (Always set to 1)
is_marketplace	Optional	set to 1 if the merchant is registered as a Marketplace Operator on Atarapay's platform
seller_phone	Yes	The AtaraPay phone number of the merchant's service provider that is registered with AtaraPay (if is_marketplace = 1)
sp_id	Optional	Service Provider ID associated to a seller
sp_commission	Optional	Service Provider Commission for a transaction
callback_url	Yes	Callback link to receive response and status from AtaraPay

Marketplace Seller Option

If you are registered as a Marketplace Operator, please set the is_marketplace parameter to 1 and seller_phone parameter to thephone number of a valid atarapay seller account on your store, but if you are registered as a Business Seller, you can leave the is_marketplace parameter as 0 and set seller_phone to null.

Your marketplace app can be integrated to AtaraPay by registering with either the Marketplace Operator or Business Seller role. For details on the differences they offer, click here.

Add the function to you the button

<form id="trustpay-form"><button id="trustpayButton" type="button" style="" onclick="payWithTrustpay()"></form>

All the fields are required.

Next Step

You should have a modal/pop-up appear after button is clicked, once you see this you are good to go 😊🚀

Contact Us

For Further Details Please Contact TrustPay for Platform API