Download the PHP package dizatech/rayanpay_ipg without Composer
On this page you can find all versions of the php package dizatech/rayanpay_ipg. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dizatech/rayanpay_ipg
More information about dizatech/rayanpay_ipg
Files in dizatech/rayanpay_ipg
Package rayanpay_ipg
Short Description Rayanpay payment gateway for Laravel
License GPL-3.0-or-later
Informations about the package rayanpay_ipg
Payment Cycle
For a payment transaction we have to request a payment via web service. If our request is successful the IPG will return a token which we should use while redirecting customer to payment page. Customer will be redirected back to our desired URL(callback URL) from payment page via a GET request carrying data which may be used to check and verify customer's transaction using web service.
Request payment
For a payment transaction we should send a payment request to IPG and acquire a token. This may be accomplished by calling getToken
method.
Instantiating an IPG object
for instantiating an IPG object we should call Dizatech\RayanpayIpg\RayanpayIpg
constructor passing it an array of required arguments containing:
- merchantId: your payment gateway merchant id
Code sample:
getToken
method
Arguments:
- amount: amount in Rials
- redirect_address: URL to which customer may be redirected after payment
Returns:
An object with the following properties:
- status:
success
orerror
- token: in case of a successful request contains the generated token which may be used while redirecting customer to payment page
- message: contains error message when
status
iserror
Redirecting customer to payment page
If
status
property of the result of callinggetToken
issuccess
we can redirect customer to payment page URL which is currentlyhttps://pms.rayanpay.com/pg/startpay/
. We have to redirect user to payment page via a GET request.
It is neccessary to save the acquired token token for further use
Code sample:
Payment verification and settle
After payment the customer will be redirected back to the callback URL provided in payment request phase via a GET request carrying all necessary data including:
- Authority: Payment token by which the user has been redirected to payment page
- Status: Payment status which should be
OK
for successful payments
If Status
equals OK
we can call the verifyRequest
method to verify payment.
verifyRequest
method
Arguments:
- amount: Original order amoun tused in payment request
- token: Authority parameter returned by IPG
Returns:
An object with the following properties:
- status:
success
orerror
- message: message describing the status
- ref_id: reference id in case of successful transaction
Code sample:
Getting success
status in response means that the transction is successful and settled.