php 对接国外支付 ipay88支付

Posted 2021-03-15 寒冬

ipay88支付

近期接了一个国外的项目，客户指定要这种支付，就搞搞呗，其实流程和思路都是差不多的，往下看

他的流程其实非常简单  下面的流程仔细看看，看懂了就会了

　　　　　　　　　　 1 首先我们需要先获取下单所需要的参数（这个需要去ipay88官网去申请），

　　　　　　　　　　　　就是下面main.php里面的一些参数merchantCode，merchantKey

　　　　　　　　　　 2 参数完整之后我们要做的就是验证签名了（下面有我的验证签名的方式，支付类文件，拿着用就好）

　　　　　　　　　　 3 当我们在页面实际付款的时候，我们需要使用一个form表单 post方式执行我们的操作，

　　　　　　　　　　　　我们需要将签名所需要的参数都以form表单的形式提交到ipay88给我们提供的地址，会自动跳转到支付页（成功唤醒就代表对接成功了）

　　　　　　　　　　4 注意form表单提交的时候，参数一定要完整

　　　　　　　　　　5 测试的时候，ipay88只支持信用卡支付（visa，master），并且支付金额只能为1元

yii-iPay88 API将帮助您为应用程序实现iPay88付款网关。此API中包含以下操作

• 正常付款
• 定期付款
• 定期付款终止
• 后端通知  

认证方式

yii-iPay88 API使用十六进制和base64编码技术来创建唯一签名。然后，此签名将用于客户端的每个请求以及iPay88服务器发送的每个响应。

基本上，此签名基于商户代码，商户密钥，付款金额，货币代码，refno。等。所有API请求都必须通过HTTPS进行。

用法

main.php

 

‘components‘ => array(
....
‘ipay‘ => array(
        ‘class‘=>‘Ipay‘,    
        ‘merchantCode‘=>‘<<merchantCode>>‘,
        ‘merchantKey‘=>‘<<merchantKey>>‘,
        ‘currencyCode‘=>‘MYR‘, // length 5                        
        ‘responseUrl‘=>‘http://<<hostname>>/ipay/response‘,
        ‘backendUrl‘=>‘http://<<hostname>>/ipaybackend/response‘,
        ‘requeryUrl‘=>‘https://www.mobile88.com/epayment/enquiry.asp‘,
        ‘paymentUrl‘=>‘https://www.mobile88.com/epayment/entry.asp‘,
        ‘recurringUrlSubscription‘=>‘https://www.ipay88.com/recurringpayment/webservice/RecurringPayment.asmx/Subscription‘,
        ‘recurringUrlTermination‘=>‘https://www.ipay88.com/recurringpayment/webservice/RecurringPayment.asmx/Termination‘
        
    ),
....
)

一个虚拟控制器，演示此组件用于iPay88正常付款的用法并获得该响应，这个也就是你传给支付类文件的参数方法

IpayController.php

class IpayController extends Controller {

    const TRANSACTION_TYPE_PAYMENT = ‘payment‘;
    const TRANSACTION_TYPE_RECURRING_SUBSCRIPTION = ‘recurring_subscription‘;
    const TRANSACTION_TYPE_RECURRING_TERMINATION = ‘recurring_termination‘;

    /*
     * iPay88 normal payment Method
     */
    public function actionPayment() {

        // Unique merchant transaction number / Order ID (Retry for same RefNo only valid for 30 mins). (length 20)
        $paymentParams[‘RefNo‘] = ‘TEST123‘;

        // (Optional) (int)
        $paymentParams[‘PaymentId‘] = ‘2‘;

        // Payment amount with two decimals.
        $paymentParams[‘Amount‘] = ‘1.00‘;

        // Product description. (length 100)
        $paymentParams[‘ProdDesc‘] = ‘This is a test product‘;

        // Customer name. (length 100)
        $paymentParams[‘UserName‘] = ‘Abc‘;

        // Customer email.  (length 100)
        $paymentParams[‘UserEmail‘] = ‘[e-mail]‘;

        // Customer contact.  (length 20)
        $paymentParams[‘UserContact‘] = ‘*************‘;

        // (Optional) Merchant remarks. (length 100)
        $paymentParams[‘Remark‘] = ‘Here is the description‘;

        $paymentFields = Yii::app()->ipay->getPaymentFields($paymentParams, self::TRANSACTION_TYPE_PAYMENT);
        $transactionUrl = Yii::app()->ipay->getTransactionUrl(self::TRANSACTION_TYPE_PAYMENT);
        $this->render(‘Payment‘, array(
            ‘paymentFields‘ => $paymentFields,
            ‘transactionUrl‘ => $transactionUrl
        ));
    }
        
}

/Ipay.php    这个就是你的支付类文件了，用的时候改一下里面的参数就可以，因为这个是基于yii框架的，你可以改一下里面的有些参数，或者删除就好

class Ipay extends CApplicationComponent {

    /**
     * Normal iPay88 payment method
     */
    const TRANSACTION_TYPE_PAYMENT = ‘payment‘;

    /**
     * Normal iPay88 recurring payment subscription
     */
    const TRANSACTION_TYPE_RECURRING_SUBSCRIPTION = ‘recurring_subscription‘;

    /**
     * Normal iPay88 recurring payment termination
     */
    const TRANSACTION_TYPE_RECURRING_TERMINATION = ‘recurring_termination‘;

    /**
     * Merchant code assigned by iPay88
     */
    public $merchantCode;
    
    /**
     * Merchant Key assigned by iPay88
     */
    public $merchantKey;
    
    /**
     * Currency Code max length 5
     */
    public $currencyCode;
    
    /**
     * Merchant code assigned by iPay88
     */    
    public $responseUrl;
    
    /*
     * Response Url or Return Url after payment
     */
    public $paymentUrl;
    
    /*
     * Backend Url or Notify Url after payment (Send response by iPay88 server)
     */
    public $backendUrl;
    
    /*
     * Requery from iPay88 server regarding bill details
     */
    public $requeryUrl;
    
     /*
     * ipay88 Recurring Payment Url
     */
    public $recurringUrlSubscription;
    
     /*
     * ipay88 Recurring Payment Termination Url
     */
    public $recurringUrlTermination;
    
    
    /*
     * Details to be sent to IPay88 for payment request.
     */    
    private $paymentRequest = array(
        ‘MerchantCode‘, // Merchant code assigned by iPay88. (length 20)
        ‘PaymentId‘, // (Optional) (int)
        ‘RefNo‘, // Unique merchant transaction number / Order ID (Retry for same RefNo only valid for 30 mins). (length 20)
        ‘Amount‘, // Payment amount with two decimals.
        ‘Currency‘, // (length 5)
        ‘ProdDesc‘, // Product description. (length 100)
        ‘UserName‘, // Customer name. (length 100)
        ‘UserEmail‘, // Customer email.  (length 100)
        ‘UserContact‘, // Customer contact.  (length 20)
        ‘Remark‘, // (Optional) Merchant remarks. (length 100)
        ‘Lang‘, // (Optional) Encoding type:- ISO-8859-1 (English), UTF-8 (Unicode), GB2312 (Chinese Simplified), GD18030 (Chinese Simplified), BIG5 (Chinese Traditional)
        ‘Signature‘,
        ‘ResponseURL‘,
        ‘BackendURL‘,
    );

    
    /*
     * Details to be sent to iPay88 for recurring subscription payment request.
     */    
    private $recurringSubscriptionRequest = array(
        ‘MerchantCode‘, // Merchant code assigned by iPay88. (length 20)
        ‘RefNo‘, // Unique merchant transaction number / Order ID. (length 20)
        ‘FirstPaymentDate‘, // (ddmmyyyy)
        ‘Currency‘, // MYR only. (length 5)
        ‘Amount‘, // Payment amount with two decimals.
        ‘NumberOfPayments‘, // (int)
        ‘Frequency‘, // Frequency type; 1 - Monthly, 2 - Quarterly, 3 - Half-Yearly, 4 - Yearly. (int)
        ‘Desc‘, // Product description. (length 100)
        ‘CC_Name‘, // Name printed on credit card. (length 100)
        ‘CC_PAN‘, // 16-digit credit card number (Visa/Mastercard). (length 16)
        ‘CC_CVC‘, // 3-digit verification code behind credit card. (length 3)
        ‘CC_ExpiryDate‘, // Credit card expiry date. (mmyyyy)
        ‘CC_Country‘, // Credit card issuing country. (length 100)
        ‘CC_Bank‘, // Credit card issuing bank. (length 100)
        ‘CC_Ic‘, // Credit card holder IC / Passport number. (length 50)
        ‘CC_Email‘, // Credit card holder email address. (length 255)
        ‘CC_Phone‘, // Credit card phone number. (length 100)
        ‘CC_Remark‘, // (Optional) Remarks. (varchar 100)
        ‘P_Name‘, // Subscriber name as printed in IC / Passport. (length 100)
        ‘P_Email‘, // Subscriber email address. (length 255)
        ‘P_Phone‘, // Subscriber phone number. (length 100)
        ‘P_Addrl1‘, // Subscriber address line 1. (length 100)
        ‘P_Addrl2‘, // (Optional) Subscriber address line 2. (length 100)
        ‘P_City‘, // Subscriber city. (length 100)
        ‘P_State‘, // Subscriber state. (length 100)
        ‘P_Zip‘, // Subscriber zip code. (length 100)
        ‘P_Country‘, // Subscriber country. (varchar 100)
        ‘BackendURL‘, // Payment backend response page. (length 255)
        ‘Signature‘, // SHA1 signature. (length 100)
    );
    
    
    /*
     * Get required payment fields
     */
    public function getPaymentFields($reqParams = null, $paymentType) {
        $retnParams = array();
        try {
            if (isset($reqParams) && (count($reqParams) > 0)) {

                if (isset($paymentType) && $paymentType != "") {
                    $paymentType = strtolower(trim($paymentType));
                    switch ($paymentType) {
                        case ‘payment‘:
                            $retnParams = $this->__getPaymentField($reqParams, $paymentType);
                            break;
                        case ‘recurring_subscription‘:
                            $retnParams = $this->__getRecurringSubscriptionField($reqParams, $paymentType);
                            break;
                        case ‘recurring_termination‘:
                            $retnParams = $this->__getRecurringTerminationField($reqParams, $paymentType);
                            break;
                    }
                } else {
                    throw new Exception("Ipay: Payment method missing");
                }
            } else {
                throw new Exception("Ipay: Required Parameters missing");
            }
        } catch (Exception $e) {
            Yii::log($e->getMessage(), CLogger::LEVEL_ERROR);
        }
        return $retnParams;
    }

    /*
     * Code for hex2bin 
     */
    public function _hex2bin($hexSource) {
        $bin = ‘‘;
        for ($i = 0; $i < strlen($hexSource); $i = $i + 2) {
            $bin .= chr(hexdec(substr($hexSource, $i, 2)));
        }
        return $bin;
    }

    /*
     * Get payment fields for normal payment fields 
     */
    public function __getPaymentField($reqParams, $paymentType) {
        $retnParams = array();
        foreach ($this->paymentRequest as $pymtKey) {
            if (isset($reqParams[$pymtKey])) {
                $retnParams[$pymtKey] = $reqParams[$pymtKey];
            } else {

                switch ($pymtKey) {
                    case ‘MerchantCode‘:
                        $retnParams[$pymtKey] = $this->merchantCode;
                        break;
                    case ‘Currency‘:
                        $retnParams[$pymtKey] = $this->currencyCode;
                        break;
                    case ‘Lang‘:
                        $retnParams[$pymtKey] = ‘UTF-8‘; //(Optional) Encoding type:- ISO-8859-1 (English), UTF-8 (Unicode), GB2312 (Chinese Simplified), GD18030 (Chinese Simplified), BIG5 (Chinese Traditional)
                        break;
                    case ‘Signature‘:
                        $retnParams[$pymtKey] = $this->__createSignature($retnParams, $paymentType); // SHA1 signature.
                        break;
                    case ‘ResponseURL‘:
                        $retnParams[$pymtKey] = $this->responseUrl; // (Optional) Payment response page.
                        break;
                    case ‘BackendURL‘:
                        $retnParams[$pymtKey] = $this->backendUrl; // (Optional) BackendURL but should security purpose
                        break;
                }
            }
        }

        return $retnParams;
    }
    
    /*
     * Get payment fields for recurring payment
     */
    public function __getRecurringSubscriptionField($reqParams, $paymentType) {
        $retnParams = array();
        foreach ($this->recurringSubscriptionRequest as $pymtKey) {
            if (isset($reqParams[$pymtKey])) {
                $retnParams[$pymtKey] = $reqParams[$pymtKey];
            } else {

                switch ($pymtKey) {
                    case ‘MerchantCode‘:
                        $retnParams[$pymtKey] = $this->merchantCode;
                        break;
                    case ‘Currency‘:
                        $retnParams[$pymtKey] = $this->currencyCode;
                        break;
                    case ‘Lang‘:
                        $retnParams[$pymtKey] = ‘UTF-8‘; //(Optional) Encoding type:- ISO-8859-1 (English), UTF-8 (Unicode), GB2312 (Chinese Simplified), GD18030 (Chinese Simplified), BIG5 (Chinese Traditional)
                        break;
                    case ‘Signature‘:
                        $retnParams[$pymtKey] = $this->__createSignature($retnParams, $paymentType); // SHA1 signature.
                        break;
                    case ‘ResponseURL‘:
                        $retnParams[$pymtKey] = $this->responseUrl; // (Optional) Payment response page.
                        break;
                    case ‘BackendURL‘:
                        $retnParams[$pymtKey] = $this->backendUrl; // (Optional) BackendURL but should security purpose
                        break;
                }
            }
        }

        return $retnParams;
    }

    
    
    /*
     * Get payment fields for recurring payment termination
     */
    public function __getRecurringTerminationField($reqParams, $paymentType) {
        $retnParams = array();
        foreach ($this->recurringSubscriptionRequest as $pymtKey) {
            if (isset($reqParams[$pymtKey])) {
                $retnParams[$pymtKey] = $reqParams[$pymtKey];
            } else {

                switch ($pymtKey) {
                    case ‘MerchantCode‘:
                        $retnParams[$pymtKey] = $this->merchantCode;
                        break;
                }
            }
        }

        return $retnParams;
    }
    
    /*
     * Create signature for payment
     */
    public function __createSignature($signatureParams, $paymentType) {
        //echo "<pre>";
        //print_r($signatureParams);
        $signature = ‘‘;
        if (isset($signatureParams)) {
            $_signatureParams = array();
            if ($paymentType == self::TRANSACTION_TYPE_PAYMENT) {
                $_signatureParams = array(‘MerchantCode‘, ‘RefNo‘, ‘Amount‘, ‘Currency‘);
            } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_SUBSCRIPTION) {
                $_signatureParams = array(‘MerchantCode‘, ‘RefNo‘, ‘FirstPaymentDate‘, ‘Currency‘, ‘Amount‘, ‘NumberOfPayments‘, ‘Frequency‘, ‘CC_PAN‘);
            } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_TERMINATION) {
                $_signatureParams = array(‘MerchantCode‘, ‘RefNo‘);
            }


            foreach ($_signatureParams as $val) {
                if (!isset($signatureParams[$val])) {
                    throw new Exception("Ipay: Missing required parameters for signature.");
                    return false;
                }
            }
        }

        // Make sure the order is correct.
        if ($paymentType == self::TRANSACTION_TYPE_PAYMENT) {
            $signature .= $this->merchantKey;
            $signature .= $signatureParams[‘MerchantCode‘];
            $signature .= $signatureParams[‘PaymentId‘];
            $signature .= $signatureParams[‘RefNo‘];
            $signature .= preg_replace("/[^d]+/", "", $signatureParams[‘Amount‘]);
            $signature .= $signatureParams[‘Currency‘];
        } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_SUBSCRIPTION) {
            $signature .= $signatureParams[‘MerchantCode‘];
            $signature .= $this->merchantKey;
            $signature .= $signatureParams[‘RefNo‘];
            $signature .= $signatureParams[‘FirstPaymentDate‘];
            $signature .= $signatureParams[‘Currency‘];
            $signature .= $signatureParams[‘Amount‘];
            $signature .= $signatureParams[‘NumberOfPayments‘];
            $signature .= $signatureParams[‘Frequency‘];
            $signature .= $signatureParams[‘CC_PAN‘];
        } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_TERMINATION) {
            $signature .= $signatureParams[‘MerchantCode‘];
            $signature .= $this->merchantKey;
            $signature .= $signatureParams[‘RefNo‘];
        }


        // Hash the signature.
        return $signature = base64_encode($this->_hex2bin(sha1($signature)));
    }

    /*
     * Get url for respective payment redirection url
     */
    public function getTransactionUrl($paymentType) {
        if ($paymentType == self::TRANSACTION_TYPE_PAYMENT) {
            return $this->paymentUrl;
        } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_SUBSCRIPTION) {
            return $this->recurringUrlSubscription;
        } else if ($paymentType == self::TRANSACTION_TYPE_RECURRING_TERMINATION) {
            return $this->recurringUrlTermination;
        }
    }


    /*
     * iPay88 payment signature validation
     */
    public function checkiPay88Signature($reqParams) {
        $status = ‘fail‘;
        try {
            if (isset($reqParams) && count($reqParams) > 0) {
                $orginalKey = $this->merchantKey . $this->merchantCode;
                if (isset($reqParams[‘RefNo‘])) {
                    $orginalKey .=$reqParams[‘RefNo‘];
                }

                if (isset($reqParams[‘Amount‘])) {
                    $orginalKey .=preg_replace("/[^d]+/", "", $reqParams[‘Amount‘]);
                }
                $orginalKey .= $this->currencyCode;
                if (isset($reqParams[‘Status‘])) {
                    $orginalKey .=$reqParams[‘Status‘];
                }

                $orginalKeyGen = base64_encode($this->_hex2bin(sha1($orginalKey)));
                $returnKey = $this->merchantKey;
                if (isset($reqParams[‘MerchantCode‘])) {
                    $returnKey .=$reqParams[‘MerchantCode‘];
                }


                if (isset($reqParams[‘RefNo‘])) {
                    $returnKey .=$reqParams[‘RefNo‘];
                }
                if (isset($reqParams[‘Amount‘])) {
                    $returnKey .=preg_replace("/[^d]+/", "", $reqParams[‘Amount‘]);
                }
                if (isset($reqParams[‘Currency‘])) {
                    $returnKey .=$reqParams[‘Currency‘];
                }
                if (isset($reqParams[‘Status‘])) {
                    $returnKey .=$reqParams[‘Status‘];
                }


                $returnKeyGen = base64_encode($this->_hex2bin(sha1($returnKey)));
                if ($orginalKeyGen === $returnKeyGen) {
                    $status = ‘success‘;
                }
            } else {
                throw new Exception("Ipay::checkiPay88Signature: Params missing");
            }
        } catch (exception $e) {
            Yii::log($e->getMessage(), CLogger::LEVEL_ERROR);
        }

        return $status;
    }

    /*
     * Curl hit to get bill deyails 
     */
    public function requeryPayment($rawPostData) {
        try {
            $result = ‘‘;
            if (is_callable(‘curl_init‘)) {
                if (isset($rawPostData) && $rawPostData != "") {
                    $ch = curl_init();
                    $url = $this->requeryUrl . ‘?‘ . $rawPostData;
                    curl_setopt($ch, CURLOPT_URL, $url);
                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                    $result = curl_exec($ch);
                    curl_close($ch);
                } else {
                    throw new Exception("Ipay::requeryPayment: No request string");
                }
            } else {
                throw new Exception("Ipay::requeryPayment: Curl not enabled");
            }
        } catch (exception $e) {
            Yii::log($e->getMessage(), CLogger::LEVEL_ERROR);
        }

        return $result;
    }

}

views / ipay / payment.php   这个相当于你的回调地址了，下单成功后跳转到这里执行你想要的操作

<?php

$rawPostData = file_get_contents(‘php://input‘);
$resultData = array();
if (strlen($rawPostData) > 0) {
    $rawPostArray = explode(‘&‘, $rawPostData);
    foreach ($rawPostArray as $keyval) {
        $keyval = explode(‘=‘, $keyval);
        if (count($keyval) == 2)
            $resultData[$keyval[0]] = urldecode($keyval[1]);
    }
}

这个就是模拟的form表单了，参照这个提交就没问题了

<FORM method="post" name="ePayment" 
action="https://payment.ipay88.com.my/ePayment/entry.asp">
<INPUT type="hidden" name="MerchantCode"  value="M00003">
<INPUT type="hidden" name="PaymentId" value="2">
<INPUT type="hidden" name="RefNo" value="A00000001">
<INPUT type="hidden" name="Amount"  value="1.00">
<INPUT type="hidden" name="Currency"  value="MYR">
<INPUT type="hidden" name="ProdDesc"  value="Photo Print">
<INPUT type="hidden" name="UserName"  value="John Tan">
<INPUT type="hidden" name="UserEmail" value="[e-mail]">
<INPUT type="hidden" name="UserContact" value="0126500100">
<INPUT type="hidden" name="Remark"  value="gfdfgd">
<INPUT type="hidden" name="Lang"  value="UTF-8">
<INPUT type="hidden" name="SignatureType" value="SHA256">
<INPUT type="hidden" name="Signature" 
value="b81af9c4048b0f6c447129f0f5c0eec8d67cbe19eec26f2cdaba5df4f4dc5a28">
<INPUT type="hidden" name="ResponseURL" 
value="http://gx.oeob.net/mobile/respons_ipay.php">
<INPUT type="hidden" name="BackendURL"  
value="http://gx.oeob.net/mobile/respons_ipay.php">
<INPUT type="submit" value="Proceed with Payment" name="Submit">
</FORM> 

如果有不明白的地方，评论给我，或者发我邮箱[e-mail]