Name: CamPay Shortcode Payment Gateway
Author: campay

CamPay is a Cameroonian fintech service of TAKWID GROUP, running since January 2021. It lets businesses and organisations collect and send money online, mainly through MTN Mobile Money and Orange Money.

With this plugin you do not need a shop or a donation plugin: place the [campay] shortcode in any page or post and your visitors can pay you, for a fixed amount or an amount they choose.

How visitors pay

Mobile Money: the visitor clicks the button, enters their MTN or Orange number and approves the payment on their phone. The payment window shows the instructions, a countdown and the result live. No prompt? They can dial 126# (MTN) or #15050# (Orange) to approve pending payments.
Debit or credit card: the visitor chooses “Debit or credit card”, pays on a secure CamPay page and comes back to your success or failure page. Cards are only offered when you enable them and card payments are activated on your CamPay account.

Features

One shortcode, as many buttons as you want on the same page
Fixed amounts, or visitor-entered amounts with suggested amounts and limits
MTN Mobile Money and Orange Money with operator detection, and debit or credit cards
Optional extra field saved with each payment (room number, invoice number, full name…)
Amounts in FCFA (XAF), US dollars or euros; USD and EUR are converted to XAF with your own rates
Default “Payment successful” and “Payment not completed” pages, created on activation, with a receipt of the payment
Payments list with totals, status, filters, search, CSV export and a details page
Pending payments are re-checked automatically, and the webhook records late confirmations
Every card return and webhook is checked with the CamPay signature and verified with the CamPay API
Shortcode builder, connection test, demo mode, dashboard widget
Real CamPay API errors in the logs and on each payment, visible to administrators only

Shortcode attributes

Every attribute is optional; missing ones use the defaults of CamPay > Settings > Payment form.

amount: fixed amount. Leave it out to let the visitor enter the amount
amounts: comma-separated suggested amounts, e.g. amounts="1000,2000,5000"
min_amount / max_amount: limits for visitor-entered amounts
currency: XAF (default), or USD / EUR when their conversion rate is enabled
product_title: what the payment is for, shown in the payment window and the payments list
product_ref: your own reference
button_text: text of the button
success_url / failure_url: pages to open after a successful or failed payment
extra_label / extra_required: optional extra text field
class: extra CSS class for the button

Examples:

[campay amount="2000" product_title="Membership" button_text="Pay"]
[campay product_title="Donation" amounts="1000,5000,10000" button_text="Donate"]

[campay_payment_status] shows the receipt of the payment the visitor just made. It is already on the default result pages.

External services

This plugin connects to the CamPay API (https://campay.net, or https://demo.campay.net in Demo mode) to process payments. It is required for the plugin to work.

Authentication: when a payment is started, a status is checked, card availability is checked or you click “Test connection”, your App Username and App Password are sent to get an access token.
Card availability: on pages with a payment button, and in the settings, when card payments are enabled the plugin asks CamPay whether cards are activated on your account (the answer is cached for up to an hour).
Mobile Money payment: when a visitor submits the payment window, the amount in XAF, the visitor’s phone number, the payment title and reference, and a unique reference are sent. The payment status is then checked until it is confirmed, and pending payments are re-checked in the background.
Card payment: when a visitor chooses to pay by card, the amount in XAF, the payment title and reference, a unique reference and the return address on your site are sent to create the payment page. The visitor enters card details on the CamPay page, not on your site.
Verification: when the visitor comes back from the card page or CamPay calls the webhook, the transaction is fetched from CamPay to confirm it.

CamPay is provided by TAKWID GROUP: terms and conditions, privacy policy. API documentation: CamPay API.