watts25/naranja-payment-sdk

Naranja Ranty - Checkout SDK


Keywords
php, rest, api, payments, sdk, openapi, openapitools, openapi-generator, naranja
License
Unlicense

Documentation

Ranty Checkout - PHP SDK

Requerimientos

  • Composer
  • PHP >=7.1
  • PHP Extensions: curl | json | mbstring | dom

Instalaci贸n

# Creamos la carpeta para el sdk
mkdir sdk
# Ingresamos a la carpeta
cd sdk
# Descomprimimos el SDK
unzip php-checkout-sdk.zip
# Instalamos las dependencias en /vendor
composer install

Ejemplo de uso

El primer paso es crear un PaymentRequest que contiene toda la informaci贸n del pago que queremos recibir:

<?php
// Importamos el SDK y las clases
require_once(__DIR__ . '/../../vendor/autoload.php');
require(__DIR__ . '/../../checkoutApi.php');

// Instanciamos la clase NaranjaCheckout
// Utilizamos el CLIENT_ID y CLIENT_SECRET provistos por Naranja
// En 'ENVIRONMENT', para las pruebas usamos 'sandbox' y para nuestro entorno productivo 'production'
// Tener en cuenta que el CLIENT_ID y el CLIENT_SECRET son distintos para sandbox y para producci贸n

$naranjaCheckout = new NaranjaCheckout('CLIENT_ID','CLIENT_SECRET','ENVIROMENT');

// Definimos el primer producto
$product1 = new Naranja\CheckoutApi\Model\ProductItem();
$product1->setName('Veggies');
$product1->setDescription('Granja del sol');
$product1->setQuantity(2);

// Definimos unit_price
$unitPrice1 = new Naranja\CheckoutApi\Model\Amount();
$unitPrice1->setCurrency('ARS');
$unitPrice1->setValue('115');

// Agregamos el unitPrice al producto
$product1-> setUnitPrice($unitPrice1);

// Definimos el segundo producto
$product2 = new Naranja\CheckoutApi\Model\ProductItem();
$product2->setName('Croquetas');
$product2->setDescription('Granja del sol'); 
$product2->setQuantity(1);

// Definimos el unit price del segundo producto
$unitPrice2 = new Naranja\CheckoutApi\Model\Amount();
$unitPrice2->setCurrency('ARS');
$unitPrice2->setValue('115');

// Agregamos el unitPrice al producto
$product2->setUnitPrice($unitPrice2);

// Definimos el objeto transaccion
$transaction = new Naranja\CheckoutApi\Model\Transaction();

// Definimos el Amount
$amountTransaction = new Naranja\CheckoutApi\Model\Amount();
$amountTransaction->setCurrency('ARS'); 
$amountTransaction->setValue('345');

// Agregamos el objeto amount a la transaccion
$transaction->setAmount($amountTransaction);
$transaction->setSoftDescriptor('GOFRIZ CONGELADOS');
$transaction->setProducts([$product1, $product2]);

// Generamos el payment request
$paymentRequest = new Naranja\CheckoutApi\Model\PaymentRequest();
$paymentRequest->setPaymentType('web_checkout');
$paymentRequest->setAuthorizationMode('SALE');
$paymentRequest->setExternalPaymentId('123456789');
$paymentRequest->setTransactions([$transaction]);

// Definimos el Requests creation redirect
$requestsCreationRedirect = new Naranja\CheckoutApi\Model\RequestCreationRedirect();
$requestsCreationRedirect->setSuccessUrl('https://gofriz.com.ar/success');
$requestsCreationRedirect->setFailureUrl('https://gofriz.com.ar/failure');

// Agregamos el requests redirect al paymenRequests
$paymentRequest->setRequestCreationRedirect($requestsCreationRedirect);
$paymentRequest->setCallbackUrl('https://gofriz.com.ar/notification');

// Ejecutamos el metodo
$response = $naranjaCheckout->createPaymentRequest($paymentRequest);

// Transformamos el JSON a datos nativo de PHP
$response = json_decode($response, true);

print_r($response['checkout_url'] . PHP_EOL);

Luego, para recibir las notificaciones, debemos implementar un endpoint que las reciba (que debe ser el mismo que especificamos en $paymentRequest->setCallbackUrl):

<?php
// Importamos el SDK y las clases
require_once(__DIR__ . '/../vendor/autoload.php');
require(__DIR__ . '/../checkoutApi.php');

// Instanciamos la clase de NaranjaCheckout
$naranjaCheckout = new NaranjaCheckout('CLIENT_ID','CLIENT_SECRET','ENVIROMENT');

// Las notificaciones sobre el pago llegan via POST
// Por lo tanto solo nos preocupamos por ese verbo http
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // El id del pago llega via request body
    $body = json_decode(file_get_contents('php://input'), true);

    // Solicitamos los detalles del pago
    $payment = $naranjaCheckout->getPayment($body['id']);

    // Mostrar los detalles del pago
    $payment = $payment->__toString();
    print_r($payment);
}
?>

Pruebas

Para probar el flujo de checkout, una vez en el webform te vamos a pedir que te loguees. Tenemos dos usuarios de prueba que podes usar para los distintos escenarios:

API

Clase

class NaranjaCheckout(string $client_id, string $client_secret, string $environment);
  • client_id: El id del cliente
  • client_secret: El secreto del cliente
  • environment: El ambiente que deseamos utilizar ( sandbox | prod )

M茅todos

createPaymentRequest

Se utiliza para crear el paymentRequest

createPaymentRequest($paymentRequestInfo);
  • paymentRequestInfo: Modelo instanciado de Naranja\CheckoutApi\Model\PaymentRequest

getPaymentRequest

getPaymentRequest(string $id);
  • id: ID del payment request a checkear

getPaymentByExternalId

getPaymentByExternalId(string $external_payment_id);
  • external_payment_id: ID externa configurada al crear el payment request

getPayment

getPayment(string $id);
  • id: ID del payment a checkear

Modelos

Naranja\CheckoutApi\Model\PaymentRequest()

M茅todos

setPaymentType( string )

Tipo de pago. S贸lo permite "web_checkout".

setAuthorizationMode( string )

Modo de autorizaci贸n. S贸lo permite "SALE".

setExternalPaymentId( string )

Un id externo, para que el vendedor pueda identificar la venta.

setTransactions( [ Naranja\CheckoutApi\Model\Transaction() ] )

Por m谩s que haya una sola transacci贸n debemos pasar un array.

setAdditionalInfo( string ) [optional]

Informaci贸n adicional.

setSellerData( Naranja\CheckoutApi\Model\SellerData() ) [optional]

Representa los datos del vendedor

setRequestCreationRedirect( Naranja\CheckoutApi\Model\RequestCreationRedirect() )

URLs a las cuales redirigir al usuario cuando termina el proceso del checkout.

setCallbackUrl( string )

URL a la cual enviar notficaciones sobre el estado de la transacci贸n.

Naranja\CheckoutApi\Model\ProductItem()[optional]

Representa un 铆tem en la compra.

M茅todos

setName( string )

Nombre del producto.

setDescription( string )

Descripci贸n del producto.

setQuantity( int )

Cantidad de productos adquiridos.

setUnitPrice( Naranja\CheckoutApi\Model\Amount() )

Precio unitario del producto.

Naranja\CheckoutApi\Model\Amount()

M茅todos

setCurrency( string )

Moneda en la cual se hizo la compra. S贸lo admite "ARS".

setValue( string )

Valor de la compra.

Naranja\CheckoutApi\Model\Transaction()

M茅todos

setAmount( Naranja\CheckoutApi\Model\Amount() )

Monto total de la transacci贸n.

setSoftDescriptor( string )[optional]

Descripci贸n con el cual queda registrado el consumo y como se ve en el resumen de cuenta.

setProducts( [ Naranja\CheckoutApi\Model\ProductItem() ] )

Los productos de la compra. Los mismos son s贸lo a t铆tulo informativo para el cliente.

Naranja\CheckoutApi\Model\SellerData()

M茅todos

setStoreId( string )

Identificador de la tienda

setSellerId( string )

Identificador del vendedor o comercio

setPosId( string )

Identificador del POS

setSystem( string )

Nombre del sistema del vendedor

setGeocode( string )

C贸digo de geolocalizaci贸n

setInvoiceData( string )

Datos discrecionales de la factura-ticket

Naranja\CheckoutApi\Model\RequestCreationRedirect()

M茅todos

setSuccessUrl( string )

La URL a la cual enviamos al cliente cuando la transacci贸n fue exitosa.

setFailureUrl( string )

La URL a la cual enviamos al cliente cuando la transacci贸n fall贸.