PHPackages josepratolopez/mercantil-ve - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. josepratolopez/mercantil-ve ActiveLibrary[Payment Processing](/categories/payments) josepratolopez/mercantil-ve =========================== Implementacion de APIs de pago web con tarjetas nacionales e internacionales del Banco Mercantil de Venezuela 1.0.5(3y ago)320MITPHP Since Aug 28Pushed 3y ago1 watchersCompare [ Source](https://github.com/josepratolopez/mercantil-pago)[ Packagist](https://packagist.org/packages/josepratolopez/mercantil-ve)[ RSS](/packages/josepratolopez-mercantil-ve/feed)WikiDiscussions master Synced 3d ago READMEChangelog (6)DependenciesVersions (8)Used By (0) MercantilVE =========== [](#mercantilve) Este es el repositorio de la colección de clases de consumo de APIs del Banco Mercantil de Venezuela para pago con tarjetas nacionales e internacionales. instanciación ------------- [](#instanciación) ``` $clientId: valor a ser enviado por header X-IBM-Client-Id (provisto por el banco) $merchantId: ID de comercio (Merchant ID, provisto por el banco) $claveCifrado: clave de cifrado (provisto por el banco) $esProductivo: define el ambiente a ser utilizado por la API (0 si es ambiente de pruebas, 1 si es ambiente productivo) ``` ``` $mercantil = new Pago(string $clientId, string $merchantId, string $claveCifrado, bool $esProductivo); ``` Datos POST del formulario de pago --------------------------------- [](#datos-post-del-formulario-de-pago) No es necesario crear un formulario de pago, ya que este paquete contiene un método que devuelve un formulario de pago. Boton de pago y formulario se obtiene mediante el llamado del método: ``` echo _buttonHtml(string $uriLogo, string $uriActionPost, double $monto) ``` Nota: parametro **$uriActionPost** se utiliza para indicar la URL del action del formulario, ese controlador debe existir en el servidor destino. ``` $_POST['card-num']: número de tarjeta $_POST['card-type']: tipo de tarjeta ("tdc": débito o crédito nacional o internacional; "tdd": tarjeta de débito de banco mercantil (Venezuela)) $_POST['account-type']: tipo de cuenta (solo aparece en caso de que se seleccione "tarjeta de débito de banco mercantil" en el campo anterior. "CA": Cuenta de Ahorros; "CC": Cuenta Corriente) $_POST['due-date']: vencimiento de tarjeta $_POST['cvv']: CVV de la tarjeta $_POST['user-firstname']: Nombre del usuario (no se envía mediante API de pago de Mercantil, puede ser usado para datos auxiliares a ser almacenados) $_POST['user-lastname']: Apellido del usuario (no se envía mediante API de pago de Mercantil, puede ser usado para datos auxiliares a ser almacenados) $_POST['user-docid']: documento de identidad del titular (Si es venezolano debe comenzar por el prefijo V, J, E, entre otros) $_POST['user-email']: Email del usuario (no se envía mediante API de pago de Mercantil, puede ser usado para datos auxiliares a ser almacenados) $_POST['amount']: Monto del pago (decimales deben ser expresados con un punto (.) en lugar de coma (,)) ``` métodos ------- [](#métodos) Para iniciar un proceso de pago: ``` $response = $mercantil->payment(string $numeroTarjeta, string $fechaVencimientoTarjeta, string $cvvtarjeta, string $tipoTarjeta, string $cedulaCliente, string $direccionIpCliente, string $userAgentNavegador, string $idVenta, double $montoVenta, string $tipoCuenta = null); ``` Ejemplo: ``` $response = $mercantil->payment("4141-4141-4141-4141", "12/2024", "369", "tdc", "V12345678", "192.168.1.1", "Chrome", "65987412", 126.35); ``` En caso de error devuelve un array asociativo con dos keys: **ResponseError** (errores provenientes del banco) y **DataSent** (trama enviada para que pueda evaluar donde está el error). En caso de éxito devuelve un array asociativo con dos keys: **Response** (respuesta del banco) y **DataSent** (trama enviada). sin embargo si la transacción es aprobada, puede utilizar el método **$mercantil->IsApproved()** que devolverá true si se aprobó o false si se rechazó la transacción. También puede usar el método **$mercantil->getTransactionReferenceId()** para obtener la referencia o ID de la transacción para control bancario cuando se requiera. Todas las respuestas están en formato JSON por lo que tomar precauciones a la hora de manejarlas. Siempre se debe hacer un **json\_decode($response,true)** si se desea manejar la respuesta como un array. ### Health Score 25 — LowBetter than 35% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community7 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 1405d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d6456b319b3643d916dc9efb4dd99d179ebd3dbecddf287d0978e599a66d3428?d=identicon)[josepratolopez](/maintainers/josepratolopez) --- Top Contributors [![josepratolopez](https://avatars.githubusercontent.com/u/23285815?v=4)](https://github.com/josepratolopez "josepratolopez (1 commits)") ### Embed Badge ![Health badge](/badges/josepratolopez-mercantil-ve/health.svg) ``` [![Health](https://phpackages.com/badges/josepratolopez-mercantil-ve/health.svg)](https://phpackages.com/packages/josepratolopez-mercantil-ve) ``` ### Alternatives [msilabs/bkash bKash Payment Gateway API for Laravel Framework. 181.2k](/packages/msilabs-bkash)[binkode/laravel-paystack A description for laravel-paystack. 112.1k](/packages/binkode-laravel-paystack) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)