PHPackages bancolombia-dev/wompi-php - 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. bancolombia-dev/wompi-php ActiveLibrary bancolombia-dev/wompi-php ========================= Paquete para php wompi Bancolombia 1.0.7(3y ago)45.1k↓88%1[1 issues](https://github.com/oscar-rey-mosquera/wompi-php/issues)1MITPHPPHP 7.2.5 || ^8.0 Since Jun 3Pushed 3y ago2 watchersCompare [ Source](https://github.com/oscar-rey-mosquera/wompi-php)[ Packagist](https://packagist.org/packages/bancolombia-dev/wompi-php)[ Docs](https://github.com/oscar-rey-mosquera/wompi-php)[ RSS](/packages/bancolombia-dev-wompi-php/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (3)Versions (9)Used By (1) [![Logo Laravel Cashier Stripe](https://camo.githubusercontent.com/4a4547a76c26e3de5ca4616640f9205aae41c1b02be7445dfc9f2d4d58380c44/68747470733a2f2f636f6d756e696461642e617070686976652e696f2f75706c6f6164732f64656661756c742f6f726967696e616c2f32582f342f346536623261393366323936326463663036663836383363313035636664643634643364313862332e706e67)](https://camo.githubusercontent.com/4a4547a76c26e3de5ca4616640f9205aae41c1b02be7445dfc9f2d4d58380c44/68747470733a2f2f636f6d756e696461642e617070686976652e696f2f75706c6f6164732f64656661756c742f6f726967696e616c2f32582f342f346536623261393366323936326463663036663836383363313035636664643634643364313862332e706e67) [![Total Downloads](https://camo.githubusercontent.com/f18691c75d5d089abfa68895351746d934dff37e082127e4b9bad1127f4dfc6e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62616e636f6c6f6d6269612d6465762f776f6d70692d706870)](https://packagist.org/packages/bancolombia-dev/wompi-php)[![Latest Stable Version](https://camo.githubusercontent.com/7f02fdfbd7d8418782d58d3511f8e8a4b0bd4e88432b76f9b648179068d07187/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62616e636f6c6f6d6269612d6465762f776f6d70692d706870)](https://packagist.org/packages/bancolombia-dev/wompi-php)[![License](https://camo.githubusercontent.com/740dd9ecff6c1af707791abdd6c078a0855380d2e9f6e55a68af39c60d579135/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f62616e636f6c6f6d6269612d6465762f776f6d70692d706870)](https://packagist.org/packages/bancolombia-dev/wompi-php) Introducción ------------ [](#introducción) Este es un paquete de la api de [wompi](https://wompi.co/) que pertenece al grupo Bancolombia para php. 💻 Instalación ------------- [](#-instalación) Para instalar utiliza [composer](https://getcomposer.org/). ``` composer require bancolombia-dev/wompi-php ``` Test ---- [](#test) Dependiendo de la llave pública y llave privada es el entorno de trabajo. 🔧 Uso del paquete ----------------- [](#-uso-del-paquete) Para iniciar a utilizar el paquete necesitas tu llave pública y llave privada de tu [cuenta wompi](https://comercios.wompi.co/developers). ``` /** * Autocarga de clases */ require_once 'vendor/autoload.php'; use Bancolombia\Wompi; Wompi::initialize([ 'public_key' => '', 'private_key' => '' ]); /** * Retorna los tokens configurados */ Wompi::getTokens(); /** * token de aceptación * @link https://docs.wompi.co/docs/en/tokens-de-aceptacion */ Wompi::acceptance_token(); /** * Métodos de pago * @link https://docs.wompi.co/docs/en/metodos-de-pago */ /** * Tarjetas de Crédito o Débito */ /** * 1. Tokeniza una tarjeta */ $token = Wompi::tokenize_card( [ "number" => "4242424242424242", // Número de la tarjeta "cvc" => "123", // Código de seguridad de la tarjeta (3 o 4 dígitos según corresponda) "exp_month" => "08", // Mes de expiración (string de 2 dígitos) "exp_year" => "28", // Año expresado en 2 dígitos "card_holder" => "José Pérez" // Nombre del tarjetahabiente ] ); /** * 2. Realiza la transacción */ $paymentCard = Wompi::card( $acceptance_token, $token->data->id, 2, // Número de cuotas [ "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); /** * Botón de Transferencia Bancolombia */ $bancolombia = Wompi::bancolombia( $acceptance_token, $payment_description, [ "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); /** * Nequi */ $nequi = Wompi::nequi( $acceptance_token, $phone, [ "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); /** * PSE */ $pse = Wompi::pse( $acceptance_token, 0, // Tipo de persona, natural (0) o jurídica (1) 'CC', // Tipo de documento, CC o NIT '985874589', // Número de documento $responses->data[0]->financial_institution_code, // Código (`code`) de la institución financiera $payment_description, // Nombre de lo que se está pagando. Máximo 30 caracteres [ "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); /** * Pago en efectivo en Corresponsales Bancarios Bancolombia */ //1 Crea la transacción $bancolombia_collect = Wompi::bancolombia_collect( $acceptance_token, [ "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); //2 Consulta la transacción creada $transaction = Wompi::transaction_find_by_id($bancolombia_collect->data->id); ``` Fuentes de pago & Tokenización ---------------------------------- [](#fuentes-de-pago--tokenización) ``` /** * Autocarga de clases */ require_once 'vendor/autoload.php'; use Bancolombia\Wompi; Wompi::initialize([ 'public_key' => '', 'private_key' => '' ]); // Tokenización cuentas Nequi $tokenNequi = Wompi::tokenize_nequi($phone); // para chequear el estado de la suscripción $subscription = Wompi::subscription_nequi($tokenNequi->data->id); //** Nota: Para tarjetas de crédito se tokeniza de la misma forma cuando se va a realizar un pago // Crea una fuente de pago Wompi::payment_sources( $tokenizeId, $customer_email, $acceptance_token ); // Crea una transacción con fuente de pago Wompi::transaction( [ "payment_source_id" => 3891 // ID de la fuente de pago "amount_in_cents" => 30300000, "currency" => "COP", "customer_email" => "user@test.com", "reference" => '0000000000', // Otros campos de la transacción a crear... ] ); ``` Links de pago ------------- [](#links-de-pago) ``` /** * Autocarga de clases */ require_once 'vendor/autoload.php'; use Bancolombia\Wompi; Wompi::initialize([ 'public_key' => '', 'private_key' => '' ]); /** * Crear link de pago * @link https://docs.wompi.co/docs/en/links-de-pago */ $link = Wompi::link([ "name" => "Pago de arriendo edificio Lombardía - AP 505", // Nombre del link de pago "description" => "Arriendo mensual", // Descripción del pago "single_use" => false, // `false` en caso de que el link de pago pueda recibir múltiples transacciones APROBADAS o `true` si debe dejar de aceptar transacciones después del primer pago APROBADO "collect_shipping" => false // Si deseas que el cliente inserte su información de envío en el checkout, o no // Otros campos de la transacción a crear... ]); $link['response']; // respuesta $link['link']; // link de pago ``` Anula una transacción --------------------- [](#anula-una-transacción) Anula una transacción APROBADA. Aplica únicamente para transacciones con Tarjeta (tipo CARD). ``` require_once 'vendor/autoload.php'; use Bancolombia\Wompi; Wompi::initialize([ 'public_key' => '', 'private_key' => '' ]); Wompi::cancell_transaction($transaction_id); ``` Verifica la autenticidad de un evento (webhook) ----------------------------------------------- [](#verifica-la-autenticidad-de-un-evento-webhook) Por seguridad necesitas checkear eventos de webhook y para eso necesitas tu [secret event](https://comercios.wompi.co/developers). ``` require_once 'vendor/autoload.php'; use Bancolombia\Wompi; Wompi::initialize([ 'public_key' => '', 'private_key' => '', //Agregar event key 'private_event_key' => '' ]); //@link https://www.geeksforgeeks.org/how-to-receive-json-post-with-php $request = file_get_contents('php://input'); //@return bool Wompi::check_webhook(json_decode($request, true))); ``` Contribución ------------ [](#contribución) Puedes contribuir agregando nuevas funcionalidades, actualizaciones, refactorización de código y notificando errores, con antelación se agradece. License ------- [](#license) [MIT license](LICENSE). ### Health Score 31 — LowBetter than 68% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity28 Limited adoption so far Community11 Small or concentrated contributor base Maturity58 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 ~1 days Total 8 Last Release 1426d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/dade78ddb6c1115a2553f1940e8d92e947b514c458bf5f8e2b8bb2eb42fb7f6d?d=identicon)[oscarrey](/maintainers/oscarrey) --- Top Contributors [![oscar-rey-mosquera](https://avatars.githubusercontent.com/u/65368810?v=4)](https://github.com/oscar-rey-mosquera "oscar-rey-mosquera (33 commits)") --- Tags phppagosonlinenequiWompiBancolombiawompi-php ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/bancolombia-dev-wompi-php/health.svg) ``` [![Health](https://phpackages.com/badges/bancolombia-dev-wompi-php/health.svg)](https://phpackages.com/packages/bancolombia-dev-wompi-php) ``` ### Alternatives [mailchimp/transactional 458.9M16](/packages/mailchimp-transactional)[ssitdikov/atol ATOL PHP API Client. Данная библиотека предназначена для работы с сервисом АТОЛ Онлайн 133.9k](/packages/ssitdikov-atol) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)