Enter details
Authorise the payment
All done
Payment page for all countries
depositId
to uniquely identify the deposit that will be processed using the payment page.
This is so that you always have a reference to the deposit you are expecting, even if you do not receive a response from us due to network errors.
This allows you to always reconcile all payments between your system and pawaPay.
You should store this depositId in your system before initiating the deposit with pawaPay.The returnUrl
specifies where the customer should be redirected to after they have gone through the payment process.The reason
field is optional. It will be shown on the payment page to the customer to indicate what they are paying for.The payment page allows them to choose the country from the dropdown.Payment page with fixed phone number
msisdn
fixes the mobile money wallet that can be used for this payment.Payment page with fixed amount
amount
specifies the amount that can be used for this payment.amount
without specifying the country
.Get a payment page with fixed amount and phone number
msisdn
(phone number) that must be used for the payment.
We have also fixed the amount
to 100 so it cannot be changed by the customer.We then need to take the customer to the payment page
redirectUrl
.redirectUrl
.Once they have completed the payment process, they will be redirected to the returnUrl
you provided in the request.And done!
How do I find out if the payment was completed?
depositId
you specified.When the payment completes you will receive a deposit callback with the final status of the payment.If you have not configured callbacks, you can poll the check deposit status endpoint.NOT_FOUND
and should be considered FAILED
after 15 minutes.returnUrl
you should validate the final status of the payment by either confirming the callback has been received or using the check deposit status endpoint.And done!
Handling failures during processing
status
of the deposit is FAILED
you can find further information about the failure from failureReason
.
It includes the failureCode
and the failureMessage
indicating what has gone wrong.failureMessage
from pawaPay API is meant for you and your support and operations teams.
You are free to decide what message to show to the customer.depositId
for the retry.UNSPECIFIED_FAILURE
code indicates that the provider indicated a failure with the payment, but did not provide any more specifics on the reason of the failure.In case there is a general failure, the UNKNOWN_ERROR
failureCode would be returned.And done!
Defensive status handling
Handling network errors and system crashes
depositId
for each payment is to ensure that you can always ask us what the status of a payment is, even if you never get a response from us.You should always store this depositId
in your system before initiating a deposit.ACCEPTED
by pawaPay.Implementing an automated reconciliation cycle
IN_RECONCILIATION
.
This means that there was a problem determining the correct final status of a payment.
When using pawaPay all payments are reconciled by default and automatically - we validate all final statuses to ensure there are no discrepancies.
When encountering payments that are IN_RECONCILIATION
you do not need to take any action.
The payment has already been sent to our automatic reconciliation engine and it’s final status will be determined soon.
The reconciliation time varies by provider. Payments that turn out to be successful are reconciled faster.