// // EGHLPayment.h // EGHLPayment // // Created by Administrator on 15-1-24. // Copyright (c) 2015年 ghl. All rights reserved. // #import #import @class PaymentRequestPARAM,PaymentRespPARAM; @protocol eGHLDelegate - (void)QueryResult:(PaymentRespPARAM *)result; @end typedef void (^onPaymentRequest)(PaymentRequestPARAM* RequestData); typedef void (^onPaymentResp)(PaymentRespPARAM* ParamData); typedef void (^onSuccessResp)(NSString* SuccessData); typedef void (^onErrorCB)(NSString* errorCode, NSString* errorData, NSError * error); @interface EGHLPayment : UIView @property (nonatomic, weak) id delegate; @property (nonatomic, strong) UILabel * loadingMessageLabel; @property (strong, nonatomic) NSString * finaliseMessage; @property (strong, nonatomic) NSString * cancelMessage; @property (strong, nonatomic) NSString * loadingMPLightBoxMessage; + (NSString *)version; /** * @method eGHLMPERequest:(PaymentRequestPARAM *)paymentParam successBlock:(onPaymentResp)success failedBlock:(onErrorCB)failed * * @param paymentParam A paymentparam object. * include ServiceID,Password,TokenType,Token,PaymentDesc,Amount,CurrencyCode. * @param success A success block. * @param failed A fail block. * @discussion Query 1st MPE Request Message. */ - (void)eGHLMPERequest:(PaymentRequestPARAM *)paymentParam successBlock:(onPaymentResp)success failedBlock:(onErrorCB)failed; /** * @method EGHLRequestSale:(PaymentRequestPARAM *)paymentparam successBlock:(onSuccessResp)successRequestCB failedBlock:(onErrorCB)failedCB * * @param paymentparam A paymentparam object. * include Amount,PaymentID,OrderNumber,MerchantName,ServiceID,PymtMethod,MerchantReturnURL,CustEmail,Password,CustPhone, * CurrencyCode,CustName,LanguageCode,PaymentDesc,PageTimeout,CustIP,MerchantApprovalURL,CustMAC,MerchantUnApprovalURL,CardHolder, * CardNo,CardExp,CardCVV2,BillAddr,ShipPostal,ShipCity,ShipRegion,ShipCountry,TokenType,Token, * SessionID,IssuingBank,MerchantCallBackURL,B4TaxAmt,TaxAmt,Param6,Param7. * @param successRequestCB A success block. * @param failedCB A fail block. * @discussion start enter to sale payment page and perform an online payment transaction. */ - (void)EGHLRequestSale:(PaymentRequestPARAM *)paymentparam successBlock:(onSuccessResp)successRequestCB failedBlock:(onErrorCB)failedCB; /** * @method paymentAPI:(PaymentRequestPARAM *)paymentparam successBlock:(onPaymentResp)successRequestCB failedBlock:(onErrorCB)failedCB * * @param paymentparam A paymentparam object. * include Amount,PaymentID,OrderNumber,MerchantName,ServiceID,PymtMethod,MerchantReturnURL,CustEmail,Password,CustPhone, * CurrencyCode,CustName,LanguageCode,PaymentDesc,PageTimeout,CustIP,MerchantApprovalURL,CustMAC,MerchantUnApprovalURL,CardHolder, * CardNo,CardExp,CardCVV2,BillAddr,ShipPostal,ShipCity,ShipRegion,ShipCountry,TokenType,Token, * SessionID,IssuingBank,MerchantCallBackURL,B4TaxAmt,TaxAmt,Param6,Param7. * @param successRequestCB A success block. * @param failedCB A fail block. * @discussion start enter to sale payment page and perform an online payment transaction. */ - (void)paymentAPI:(PaymentRequestPARAM *)paymentparam successBlock:(onPaymentResp)successRequestCB failedBlock:(onErrorCB)failedCB; /* * @method EGHLRequestQuery:(PaymentRequestPARAM *)paymentparam successBlock:(onSuccessResp)successRequestCB failedBlock:(onErrorCB)failedCB * * @param PaymentPARAMCB A PaymentPARAMCB object. * include TransactionType,PymtMethod,ServiceID,PaymentID,Amount,CurrencyCode. * @param successRequestCB A success block. * @param failedCB A fail block. * @discussion query payment status. */ - (void)EGHLRequestQuery:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB; /** * @method EGHLRequestReversal:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB * * @param PaymentPARAMCB A PaymentPARAMCB object. * include TransactionType,PymtMethod,ServiceID,PaymentID,Amount,CurrencyCode. * @param successAnalyCB A success block. * @param failedCB A fail block. * @discussion reverse the original sale/payment. */ - (void)EGHLRequestReversal:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB; /* * @method EGHLRequestRefund:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB * * @param PaymentPARAMCB A PaymentPARAMCB object. * include TransactionType,PymtMethod,ServiceID,PaymentID,Amount,CurrencyCode. * @param successRequestCB A success block. * @param failedCB A fail block. * @discussion refund the original sale/payment. */ - (void)EGHLRequestRefund:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB; /* * @method EGHLRequestCapture:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB * * @param PaymentPARAMCB A PaymentPARAMCB object. * include TransactionType,PymtMethod,ServiceID,PaymentID,Amount,CurrencyCode. * @param successRequestCB A success block. * @param failedCB A fail block. * @discussion capture the original authorization transaction. */ - (void)EGHLRequestCapture:(PaymentRequestPARAM *)PaymentPARAMCB successBlock:(onPaymentResp)successAnalyCB failedBlock:(onErrorCB)failedCB; /* * @method SaleViewStopLoad * * @discussion exit payment page. */ - (void)saleViewStopLoad; /* * @method finalizeTransaction * * @discussion request SDK to finalize the current Transaction. */ - (void)finalizeTransaction; @end #pragma mark - /** * @description Parameter Class for GHL API * * Amount, PaymentID, OrderNumber, MerchantName, ServiceID, PymtMethod, MerchantReturnURL, CustEmail, Password, CustPhone, CurrencyCode, CustName, LanguageCode, PaymentDesc, PageTimeout, CustIP, MerchantApprovalURL, CustMAC, MerchantUnApprovalURL, CardHolder, CardNo, CardExp, CardCVV2, BillAddr, BillPostal, BillCity, BillRegion, BillCountry, ShipAddr, ShipPostal, ShipCity, ShipRegion, ShipCountry, TokenType, Token, SessionID, IssuingBank, MerchantCallBackURL, B4TaxAmt, TaxAmt, Param6, Param7 * * * Masterpass Fields: * * ReqVerifier, PairingVerifier, CheckoutResourceURL, ReqToken, PairingToken */ @interface PaymentRequestPARAM : NSObject @property BOOL realHost; @property (strong, nonatomic) NSString * Amount; @property (strong, nonatomic) NSString * PaymentID; @property (strong, nonatomic) NSString * OrderNumber; @property (strong, nonatomic) NSString * MerchantName; @property (strong, nonatomic) NSString * ServiceID; @property (strong, nonatomic) NSString * PymtMethod; @property (strong, nonatomic) NSString * MerchantReturnURL; @property (strong, nonatomic) NSString * CustEmail; @property (strong, nonatomic) NSString * Password; @property (strong, nonatomic) NSString * CustPhone; @property (strong, nonatomic) NSString * CurrencyCode; @property (strong, nonatomic) NSString * CustName; @property (strong, nonatomic) NSString * LanguageCode; @property (strong, nonatomic) NSString * PaymentDesc; @property (strong, nonatomic) NSString * PageTimeout; @property (strong, nonatomic) NSString * CustIP; @property (strong, nonatomic) NSString * MerchantApprovalURL; @property (strong, nonatomic) NSString * CustMAC; @property (strong, nonatomic) NSString * MerchantUnApprovalURL; @property (strong, nonatomic) NSString * CardHolder; @property (strong, nonatomic) NSString * CardNo; @property (strong, nonatomic) NSString * CardExp; @property (strong, nonatomic) NSString * CardCVV2; @property (strong, nonatomic) NSString * BillAddr; @property (strong, nonatomic) NSString * BillPostal; @property (strong, nonatomic) NSString * BillCity; @property (strong, nonatomic) NSString * BillRegion; @property (strong, nonatomic) NSString * BillCountry; @property (strong, nonatomic) NSString * ShipAddr; @property (strong, nonatomic) NSString * ShipPostal; @property (strong, nonatomic) NSString * ShipCity; @property (strong, nonatomic) NSString * ShipRegion; @property (strong, nonatomic) NSString * ShipCountry; @property (strong, nonatomic) NSString * TransactionType; @property (strong, nonatomic) NSString * TokenType; @property (strong, nonatomic) NSString * Token; @property (strong, nonatomic) NSString * SessionID; @property (strong, nonatomic) NSString * IssuingBank; @property (strong, nonatomic) NSString * MerchantCallBackURL; @property (strong, nonatomic) NSString * B4TaxAmt; @property (strong, nonatomic) NSString * TaxAmt; @property (strong, nonatomic) NSString * Param6; @property (strong, nonatomic) NSString * Param7; @property (strong, nonatomic) NSString * EPPMonth; @property (strong, nonatomic) NSString * PromoCode; @property (nonatomic) CGFloat sdkTimeOut; #pragma mark Masterpass fields @property (strong, nonatomic) NSString * ReqVerifier; @property (strong, nonatomic) NSString * PairingVerifier; @property (strong, nonatomic) NSString * CheckoutResourceURL; @property (strong, nonatomic) NSString * ReqToken; @property (strong, nonatomic) NSString * PairingToken; @property (strong, nonatomic) NSString * CardId; @property (strong, nonatomic) NSString * PreCheckoutId; /** Lightbox Paramter reference https://developer.mastercard.com/page/masterpass-lightbox-parameters */ //--------------- @property (strong, nonatomic) NSDictionary * mpLightboxParameter; @end #pragma mark - @interface PaymentRespPARAM : NSObject @property (strong, nonatomic) NSString * Amount; @property (strong, nonatomic) NSString * AuthCode; @property (strong, nonatomic) NSString * BankRefNo; @property (strong, nonatomic) NSString * CardExp; @property (strong, nonatomic) NSString * CardHolder; @property (strong, nonatomic) NSString * CardNoMask; @property (strong, nonatomic) NSString * CardType; @property (strong, nonatomic) NSString * CurrencyCode; @property (strong, nonatomic) NSString * EPPMonth; @property (strong, nonatomic) NSString * EPP_YN; @property (strong, nonatomic) NSString * HashValue; @property (strong, nonatomic) NSString * HashValue2; @property (strong, nonatomic) NSString * IssuingBank; @property (strong, nonatomic) NSString * OrderNumber; @property (strong, nonatomic) NSString * PromoCode; @property (strong, nonatomic) NSString * PromoOriAmt; @property (strong, nonatomic) NSString * Param6; @property (strong, nonatomic) NSString * Param7; @property (strong, nonatomic) NSString * PaymentID; @property (strong, nonatomic) NSString * PymtMethod; @property (strong, nonatomic) NSString * QueryDesc; @property (strong, nonatomic) NSString * ServiceID; @property (strong, nonatomic) NSString * SessionID; @property (strong, nonatomic) NSString * SettleTAID; @property (strong, nonatomic) NSString * TID; @property (strong, nonatomic) NSString * TotalRefundAmount; @property (strong, nonatomic) NSString * Token; @property (strong, nonatomic) NSString * TokenType; @property (strong, nonatomic) NSString * TransactionType; @property (strong, nonatomic) NSString * TxnExists; @property (strong, nonatomic) NSString * TxnID; @property (strong, nonatomic) NSString * TxnMessage; @property (strong, nonatomic) NSString * TxnStatus; @property (strong, nonatomic) NSString * RespTime; //--------------- #pragma mark Masterpass fields //--------------- @property (strong, nonatomic) NSString * ReqToken; @property (strong, nonatomic) NSString * PairingToken; @property (strong, nonatomic) NSString * PreCheckoutId; @property (strong, nonatomic) NSArray * Cards; @property (nonatomic, strong) NSDictionary * mpLightboxError; @end