Title iPay88 PH-Straight/Direct API (Version 2.0) ✅

Online Payment Switching Gateway Technical Specification for Straight Payments Version 2.0
iPay88 PH Technical Specification for Straight/Direct API Version 2.0 Table of Contents Table of Contents 2 Document Change Control 3 Introduction 4 1.1 Pre-Requisite of Merchant Integration 4 1.2 Transaction Flow Diagram 5 Merchant Integration 6 2.1 Endpoint URL 6 2.2 Merchant URL 6 2.3 Payment Request Parameters 7 2.3.1 Sample HTML Source Code (Payment Request) 8 2.4 Payment Response Parameters 9 2.4.1 Sample HTML Source Code (Payment Response) 10 2.4.1.1 ASP Sample Code 10 2.4.1.2 PHP Sample Code 10 Response and Backend URL Handling 11 Backend Post Feature 12 3.1 Implementation 12 Inquiry Payment Status 13 4.1 Request Parameters (Single Transaction) 13 4.2 Response Parameters (Single Transaction) 13 4.3 Request Parameters (Batch Transaction) 15 4.4 Response Parameters (Batch Transaction) 17 Security Control 19 5.1 Request Page Signature 20 5.2 Response Page Signature 21 5.3 Sample Function Code to Generate iPay88 OPSG Signature 22 Reports and Notification 24 6.1 Merchant Transaction Report 24 6.2 Email Notification Disclaimer 24 6.2.1 Customer Payment Receipt Email 25 6.2.2 Merchant Payment Notification Email 26 Copyright © iPay88 Philippines. All rights reserved. No part of this publication may be reproduced except as permitted by the copyright owners. 2
iPay88 PH Technical Specification for Straight/Direct API Version 2.0 Document Change Control Change Date Author’s Name Description 08/31/2022 Aubrey Crisostomo Updated the email notification screenshot 02/10/2023 Aubrey Crisostomo Updated the Inquiry API (Section 2.8, Pages 12 - 17) Copyright © iPay88 Philippines. All rights reserved. No part of this publication may be reproduced except as permitted by the copyright owners. 3
iPay88 PH Technical Specification for Straight/Direct API Version 2.0 Introduction This document outlines the requirements, transaction flow diagram, required parameters, and detailed information regarding the functionality of iPay88 OPSG for Straight/Direct payments. The iPay88 Straight/Direct API enables merchants to initiate payment transactions from their website or application while redirecting customers to the iPay88 payment page for secure payment processing. This approach ensures compliance with security standards while providing a seamless payment experience. 1.1 Pre-Requisite of Merchant Integration Before proceeding with the integration process, ensure the following items are prepared: ● Merchant Code and Merchant Key: These credentials must be obtained from iPay88 for secure access to the API. ● Request URL: The merchant must provide the Request URL to the iPay88 Application Support Team. ○ URL Requirements: ○ Must be IP or domain-based. ○ LocalHost is not allowed for security reasons. i️ Important Notice ● Test transactions must originate from the registered Request URL. ● Test transactions should be a minimum amount of PHP 15.00. ● Test transactions are limited to credit card payments only. Other payment options must be tested in the Production Environment. ● iPay88 OPSG does not guarantee email notifications, as email delivery depends on the ISP. 💡Tip: Don’t rely on email notifications for action confirmation. Always use the Merchant Report Portal to check the transaction status. ● Merchants must notify the iPay88 Support Team of the intended live date of the merchant account a minimum of three working days in advance. Copyright © iPay88 Philippines. All rights reserved. No part of this publication may be reproduced except as permitted by the copyright owners. 4