compropago / php-sdk
PHP SDK for ComproPago API
Installs: 6 666
Dependents: 3
Suggesters: 0
Security: 0
Stars: 7
Watchers: 14
Forks: 5
Open Issues: 0
Requires
- php: >=5.6
- rmccue/requests: ^1.7
Requires (Dev)
- phpunit/phpunit: >=4.8
- squizlabs/php_codesniffer: ^3.3
README
Introducción
Con ComproPago puede recibir pagos vía SPEI y en efectivo.
La librería de ComproPago PHP SDK le permite interactuar con el API de ComproPago en su aplicación.
También cuenta con los métodos necesarios para facilitarle su desarrollo por medio de los servicios
más utilizados.
Índice de contenidos
- Ayuda y soporte de ComproPago
- Requerimientos
- Instalación
- Guía básica de uso
- Métodos base del SDK
- Enviar instrucciones por SMS
- Webhooks
Ayuda y soporte de ComproPago
Puede obtener información acerca de nuestros servicios en alguno de los siguientes enlaces:
- Centro de ayuda y soporte
- Solicitar integración
- Guía para empezar a usar ComproPago
- Información de contacto
En caso de tener alguna pregunta o requerir el apoyo técnico, por favor contacte al correo: soporte@compropago.com y proporcionando la siguiente información:
- Nombre completo del propietario de la cuenta.
- URL del sitio web de la tienda.
- Teléfono local o celular.
- Correo electrónico del propietario de la cuenta.
- Texto detallado de la duda o requerimiento.
- En caso de presentar algún problema técnico, por favor enviar capturas de pantalla o evidencia para una respuesta más efectiva.
Requerimientos
Instalación
Instalación por Composer
Puede descargar el SDK directamente desde el repositorio de Composer con el siguiente comando:
composer require compropago/php-sdk && composer -o dumpautoload
O si lo prefiere, puede incluir directamente en su archivo composer.json el siguiente código:
{
"require" : {
"compropago/php-sdk": "*"
}
}
Posteriormente deberá instalar las dependencias usando el siguiente comando:
composer install
Instalación por Github
Puede descargar alguna de las versiones que hemos publicado aquí:
O si lo desea puede clonar nuestro repositorio de la siguiente forma:
# Repositorio en su estado actual (Puede ser una versión inestable)
git clone https://github.com/compropago/compropago-php.git
Guía básica de uso
Se debe contar con una cuenta activa de ComproPago.
Importación
<?php require 'vendor/autoload.php'; # Importar objeto Spei use CompropagoSdk\Resources\Payments\Spei; # Importar objeto Cash use CompropagoSdk\Resources\Payments\Cash;
Uso básico de la libreria
Para poder hacer uso del SDK y procesar las llamadas al API, es necesario que configurar sus llaves de conexión y crear un instancia de Cash o Spei. Sus llaves las encontrara en su Panel de ComproPago en el menú Configuración.
Instacia de objecto Spei para cobros mediante transferencia
<?php /** * Configuración de las llaves de ComproPago * * @param string $public Llave pública correspondiente al modo de la tienda * @param string $private Llave privada correspondiente al modo de la tienda */ $compropagoSpei = (new Spei)->withKeys( 'pk_test_xxxxxxxxxxxxxxxxxx', 'sk_test_xxxxxxxxxxxxxxxxxx' );
Instacia de objecto Cash para cobros en efectivo
<?php /** * Configuración de las llaves de ComproPago * * @param string $public Llave pública correspondiente al modo de la tienda * @param string $private Llave privada correspondiente al modo de la tienda */ $compropagoCash = (new Cash)->withKeys( 'pk_test_xxxxxxxxxxxxxxxxxx', 'sk_test_xxxxxxxxxxxxxxxxxx' );
Métodos base del SDK
Ordenes de pago mediante trasferencia (SPEI)
Crear una nueva orden de pago
<?php # Información de la orden $data = [ "product" => [ "id" => "10001", "price" => 258.99, "name" => "Test ComproPago SPEI", "currency" => "MXN", "url" => "http://dummyurl.com/prod10001.jpg" ], "customer" => [ "id" => "123454", "name" => "Nombre del Cliente", "email" => "cliente@dominio.com", "phone" => "55222999888" ], "payment" => [ "type" => "SPEI" ], "expiresAt" => 1556555092 ]; /** * Creación de orden para cobro mediante trasnferencia (SPEI) por medio de ComproPago * * @param array $data Información de la orden * @return array Estructura con información de la orden generada en SPEI */ $order = $compropagoSpei->createOrder($data);
Verificar el estatus de la orden
<?php /** * Verificar la información de una orden SPEI * * @param string $orderId ID de la orden generada por medio de SPEI * @return array Estructura con información de la orden generada en SPEI */ $verified = $compropagoSpei->verifyOrder($order['data']['id']);
Ordenes de pago en efectivo
Listar proveedores para pago en efectivo
<?php /** * Listar proveedores para pago en efectivo disponibles para su tienda * * @param float $limit Monto límite que el proveedor puede que aceptar * @param string $currency Moneda para el monto límite */ $providers = $compropagoCash->getProviders( $limit = 0, $currency = 'MXN' );
Crear una nueva orden de pago en efectivo
<?php $data = [ "order_id" => "10002", "order_name" => "Test ComproPago CASH", "order_price" => 157.25, "image_url" => "http://dummyurl.com/prod10002.jpg", "customer_name" => "Nombre del Cliente", "customer_email" => "cliente@dominio.com", "customer_phone" => "55222999888", "currency" => 'MXN', "payment_type" => "OXXO" ]; /** * Creación de orden para cobro en efectivo por medio de ComproPago * * @param array $data Información de la orden * @return array Estructura con información de la orden generada */ $order = $compropagoCash->createOrder($data);
Verificar el estatus de la orden
<?php /** * Verificar la información de una orden en efectivo * * @param string $orderId ID de la orden generada por medio de efectivo * @return array Estructura con información de la orden generada en efectivo */ $verified = $compropagoCash->verifyOrder($order['id']);
Enviar instrucciones por SMS
Para poder enviar las instrucciones de pago mediante mensajes SMS, deberá crear
una instancia del objecto SMS y porsteriormente configurar sus llaves de acceso.
<?php # Importar objeto Sms use CompropagoSdk\Resources\Sms; /** * Configuración de las llaves de ComproPago * * @param string $public Llave pública correspondiente al modo de la tienda * @param string $private Llave privada correspondiente al modo de la tienda */ $compropagoSms = (new Sms)->withKeys( 'pk_test_xxxxxxxxxxxxxxxxxx', 'sk_test_xxxxxxxxxxxxxxxxxx' ); /** * Llamada al método del API para envío de las instrucciones por SMS * * @param $phoneNumber Número al cual se enviaran las instrucciones * @param $orderId Id de la orden de compra de la cual se enviaran las instrucciones */ $smsInfo = $compropagoSms->sendToOrder( "55xxxxxxxx", "ch_xxxxx-xxxxx-xxxxx-xxxxx" );
Webhooks
Los webhooks son de suma importancia para el procesamiento de las ordenes de ComproPago, estos se encargaran de recibir las notificaciones del cambio en los estatus en las ordenes de compra generadas; también deberán contener parte de la lógica de aprobación en su tienda en linea. El proceso que siguen es el siguiente.
- Cuando una orden cambia su estatus, nuestra plataforma le notificara a cada una de las rutas registradas.
- Dicha notificacion cuenta con la información de la orden modificada en formato JSON.
Los webhooks registrados se pueden visualizar en el panel de ComproPago
Para poder acceder a las funciones del API que controlan los webhook,
deberá crear una instancia del objecto Webhook.
<?php # Importar objeto Webhook use CompropagoSdk\Resources\Webhook; /** * Configuración de las llaves de ComproPago * * @param string $public Llave pública correspondiente al modo de la tienda * @param string $private Llave privada correspondiente al modo de la tienda */ $compropagoWebhook = (new Webhook)->withKeys( 'pk_test_xxxxxxxxxxxxxxxxxx', 'sk_test_xxxxxxxxxxxxxxxxxx' );
Registrar un nuevo webhook
<?php /** * @param string $url URL que será registrada como EndPoint del webhook * @return array Estructura del Webhook */ $webhookInfo = $compropagoWebhook->create( "https://mitienda.com/webhook" );
Listar webhooks registrados
<?php /** * @return array Estructura del Webhook */ $listWebhooks = $compropagoWebhook->getAll();
Actualizar un webhook
/** * @param string $webhookId ID de un webhook previamente registrado * @param string $url URL nueva que será registrada como EndPoint del webhook * @return array Estructura del Webhook */ <?php $webhookInfo = $obj->update( $webhookInfo['id'], "https://mitienda.com/new_webhook" );
Eliminar un webhook
<?php /** * @param string $webhookId ID de un webhook previamente registrado * @return array Estructura del Webhook */ $webhookInfo = $compropagoWebhook->delete($webhookInfo['id']);