LVIII. MCVE支払い関数

導入

以下の関数はMCVE API(libmcve)のインターフェイスで、 PHPスクリプトからMCVEを直接使用することができるようになります。 MCVEは、Main Street Softworksのソリューションであり、直接クレジットカード処理が可能です。MCVEは、*nixマシン、モデムまたはインターネット接続により、直接クレジットカードを処理することを可能とします。(Authorize.NetやPay Flow Proのような付加的なサービスは不要となります)PHPでMCVEモジュールを使用することにより、PHPスクリプトで MCVEを通じて直接クレジットカード処理が可能となります。以下のリファレンスに処理の概要を示します。

注意: MCVEは、RedHatのCCVSを置き換えるものです。MCVEは、2001末にRedHat に採用され、全ての既存システムをMCVEプラットフォームに移行することになりました。

注意: この拡張モジュールはWindows環境では利用できません。

インストール手順

MCVEサポートをPHPで有効にするには、まず、システムのLibMCVEインストールディレクトリを調べて下さい。 --with-mcve[=DIR]オプションを指定してPHPのconfigureを実行する必要があります。このオプションをMCVEインストールパスを指定せずに使用した場合、PHPはデフォルトのLibMCVEインストールパス(/usr/local) を探します。MCVEが標準以外のパスにある場合、 --with-mcve=$mcve_pathを指定して configureを実行して下さい。ただし、$mcve_pathはMCVEをインストールしたパスです。MCVEサポートは、$mcve_path/libおよび$mcve_path/includeが存在し、includeディレクトリの下にmcve.h、 libディレクトリの下にlibmcve.soおよび libmcve.aが存在することを必要とすることに注意して下さい。

MCVEは、サーバー/クライアントを完全に分離しているため、 PHPでMCVEサポートを実行する際に追加するべきものはありません。 PHPでMCVE拡張モジュールをテストするには、IPの場合は testbox.mcve.comのポート8333、SSLの場合はポート8444をMCVE PHP APIにより接続することができます。ユーザ名として'vitale'、パスワードとして'test'を使用して下さい。テスト機能に関する詳細な情報については、 www.mcve.comにあります。

以下も参照下さい:

MCVEのPHP APIに関する追加のドキュメントについては、 http://www.mainstreetsoftworks.com/docs/phpapi.pdfにあります。 Main Streetのドキュメントは完全で、関数の最も重要なリファレンスとするべきです。

目次
mcve_adduser -- Add an MCVE user using usersetup structure
mcve_adduserarg -- Add a value to user configuration structure
mcve_bt -- Get unsettled batch totals
mcve_checkstatus -- Check to see if a transaction has completed
mcve_chkpwd -- Verify Password
mcve_chngpwd -- Change the system administrator's password
mcve_completeauthorizations -- Number of complete authorizations in queue, returning an array of their identifiers
mcve_connect -- Establish the connection to MCVE
mcve_connectionerror -- Get a textual representation of why a connection failed
mcve_deleteresponse -- Delete specified transaction from MCVE_CONN structure
mcve_deletetrans -- Delete specified transaction from MCVE_CONN structure
mcve_deleteusersetup -- Deallocate data associated with usersetup structure
mcve_deluser -- Delete an MCVE user account
mcve_destroyconn -- Destroy the connection and MCVE_CONN structure
mcve_destroyengine -- Free memory associated with IP/SSL connectivity
mcve_disableuser -- Disable an active MCVE user account
mcve_edituser -- Edit MCVE user using usersetup structure
mcve_enableuser -- Enable an inactive MCVE user account
mcve_force -- Send a FORCE to MCVE. (typically, a phone-authorization)
mcve_getcell -- Get a specific cell from a comma delimited response by column name
mcve_getcellbynum -- Get a specific cell from a comma delimited response by column number
mcve_getcommadelimited -- Get the RAW comma delimited data returned from MCVE
mcve_getheader -- Get the name of the column in a comma-delimited response
mcve_getuserarg -- Grab a value from usersetup structure
mcve_getuserparam -- Get a user response parameter
mcve_gft -- Audit MCVE for Failed transactions
mcve_gl -- Audit MCVE for settled transactions
mcve_gut -- Audit MCVE for Unsettled Transactions
mcve_initconn -- Create and initialize an MCVE_CONN structure
mcve_initengine -- Ready the client for IP/SSL Communication
mcve_initusersetup -- Initialize structure to store user data
mcve_iscommadelimited -- Checks to see if response is comma delimited
mcve_liststats -- List statistics for all users on MCVE system
mcve_listusers -- List all users on MCVE system
mcve_maxconntimeout -- The maximum amount of time the API will attempt a connection to MCVE
mcve_monitor -- Perform communication with MCVE (send/receive data) Non-blocking
mcve_numcolumns -- Number of columns returned in a comma delimited response
mcve_numrows -- Number of rows returned in a comma delimited response
mcve_override -- Send an OVERRIDE to MCVE
mcve_parsecommadelimited -- Parse the comma delimited response so mcve_getcell, etc will work
mcve_ping -- Send a ping request to MCVE
mcve_preauth -- Send a PREAUTHORIZATION to MCVE
mcve_preauthcompletion -- Complete a PREAUTHORIZATION... Ready it for settlement
mcve_qc -- Audit MCVE for a list of transactions in the outgoing queue
mcve_responseparam -- Get a custom response parameter
mcve_return -- Issue a RETURN or CREDIT to MCVE
mcve_returncode -- Grab the exact return code from the transaction
mcve_returnstatus -- Check to see if the transaction was successful
mcve_sale -- Send a SALE to MCVE
mcve_setblocking -- Set blocking/non-blocking mode for connection
mcve_setdropfile -- Set the connection method to Drop-File
mcve_setip -- Set the connection method to IP
mcve_setssl_files -- Set certificate key files and certificates if server requires client certificate verification
mcve_setssl -- Set the connection method to SSL
mcve_settimeout -- Set maximum transaction time (per trans)
mcve_settle -- Issue a settlement command to do a batch deposit
mcve_text_avs -- Get a textual representation of the return_avs
mcve_text_code -- Get a textual representation of the return_code
mcve_text_cv -- Get a textual representation of the return_cv
mcve_transactionauth -- Get the authorization number returned for the transaction (alpha-numeric)
mcve_transactionavs -- Get the Address Verification return status
mcve_transactionbatch -- Get the batch number associated with the transaction
mcve_transactioncv -- Get the CVC2/CVV2/CID return status
mcve_transactionid -- Get the unique system id for the transaction
mcve_transactionitem -- Get the ITEM number in the associated batch for this transaction
mcve_transactionssent -- Check to see if outgoing buffer is clear
mcve_transactiontext -- Get verbiage (text) return from MCVE or processing institution
mcve_transinqueue -- Number of transactions in client-queue
mcve_transnew -- Start a new transaction
mcve_transparam -- Add a parameter to a transaction
mcve_transsend -- Finalize and send the transaction
mcve_ub -- Get a list of all Unsettled batches
mcve_uwait -- Wait x microsecs
mcve_verifyconnection -- Set whether or not to PING upon connect to verify connection
mcve_verifysslcert -- Set whether or not to verify the server ssl certificate
mcve_void -- VOID a transaction in the settlement queue