API Documentation

<?php
    $my_payment_url = "https://www.uat.raksmeypay.com/payment/request/YOUR_PROFILE_ID";
    $profile_key = "YOUR_PROFILE_KEY"; //Replace with your Profile Key
    $transaction_id = 12345678;  // Replace with a unique transaction ID
    $amount = 0.01; // Replace with your transaction amount
    $success_url = urlencode("https://yoursite.com/payment/success?transaction_id=12345678");
    $remark = "payment from Mr.A";
    $hash = sha1($profile_key . $transaction_id . $amount . $success_url . $remark);
    $parameters = [
        "transaction_id" => $transaction_id,
        "amount" => $amount,
        "success_url" => $success_url,
        "remark" => $remark,
        "hash" => $hash
    ];
    $queryString = http_build_query($parameters);
    $payment_link_url = $my_payment_url."?".$queryString;

    //Here is Payment button to put on your website
    echo '<a style="background: #1a9bfc; color: white; padding: 10px 20px;" href="'.$payment_link_url.'">Pay Now</a>';
?>

<?php

    $profile_key = "YOUR_PROFILE_KEY"; //Replace with your Profile Key
    $transaction_id = "YOUR_TRANSACTION_ID"; // Replace with your transaction ID

    // RaksmeyPay sends the following parameters as GET variables appended to your Success URL
    $success_time = $_GET["success_time"] ?? "";
    $success_amount = $_GET["success_amount"] ?? "";
    $bakong_hash = $_GET["bakong_hash"] ?? "";
    $success_hash = $_GET["success_hash"] ?? "";

    // Validate token expiration (180 seconds)
    if (empty($success_amount) || (time() - $success_time) > 180) {
        die("Token expired");
    }

    // Compute hash for validation
    $b4hash = $profile_key . $success_time . $success_amount . $bakong_hash . $transaction_id;
    $hash = sha1($b4hash);

    if ($success_hash === $hash) {
        // Handle successful payment
        // Ensure proper validation to prevent duplicate service provision
        echo "Payment successful";
    } else {
        die("Invalid hash");
    }

?>

<?php
    $payment_verify_url = "https://www.uat.raksmeypay.com/api/payment/verify/YOUR_PROFILE_ID";
    $profile_key = "YOUR_PROFILE_KEY"; //Replace with your Profile Key
    $transaction_id = 12345678; // Replace with your transaction ID
    $transaction_amount = 0.01; // Replace with your transaction amount
    $hash = sha1($profile_key . $transaction_id);
    $data = [
        "transaction_id" => $transaction_id,
        "hash" => $hash
    ];
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $payment_verify_url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    $response = json_decode($response, 1);
    // Ensure that the Payment Status and Payment Amount are correctly validated to match your transaction.
    if(!empty($response["payment_status"])
        && strtoupper($response["payment_status"]) == "SUCCESS"
        && $response["payment_amount"] == $transaction_amount){
        //code to handle payment success
        // *** Proper validation is necessary on your side to prevent the service from being provided more than once.
        echo "payment success";
    }
?>

{"status":1,"payment_amount":0.01,"payment_status":"SUCCESS"}

{"status":1,"payment_amount":0.01,"payment_status":"PENDING"}

{"status":0,"err_msg":"Payment not found"}