> Importante: Si recibe un código de respuesta diferente a los antes descritos deben ser tomados como errores de protocolo HTTP.

Tarjetas de prueba

Para realizar las pruebas, se provee de los siguientes datos para comprobar la integracio?n:

• Tarjetas Aprobadas:

Pueden indicar cualquier valor para Ce?dula o RIF, Fecha de Vencimiento y CVC:

• Visa: `4111111111111111`
• American Express: `378282246310005`
• MasterCard: `5105105105105100`
• Sambil: `8244001100110011`
• Rattan: `8244021100110011`
• Locatel: `8244041100110011`

API

Instanciación

$api = new \Instapago\Api('<keyId>','<publicKeyId>');

Crear un Pago Directo

Efectúa un pago directo con tarjeta de crédito, los pagos directos son inmediatamente debitados del cliente y entran en el proceso bancario necesario para acreditar al beneficiario.

try{
  $api = new Api('<keyId>','<publicKeyId>');

  $respuesta = $api->directPayment($paymentData);
  // hacer algo con $respuesta
}catch(\Instapago\Exceptions\InstapagoException $e){

  echo "Ocurrió un problema procesando el pago.";
  // manejar el error 
}

Reservar un Pago

Efectúa una reserva o retención de pago en la tarjeta de crédito del cliente, la reserva diferirá los fondos por un tiempo (3 días máximo segun fuentes extraoficiales), en el plazo en el que los fondos se encuentren diferidos, ni el beneficiario ni el cliente poseen el dinero. El dinero será tramitado al beneficiario una vez completado el pago, o de lo contrario será acreditado al cliente de vuelta si no se completa durante el plazo o si se cancela el pago.

try{
  $api = new Api('<keyId>','<publicKeyId>');

  $respuesta = $api->reservePayment($paymentData);
  // hacer algo con $respuesta
}catch(\Instapago\Exceptions\InstapagoException $e){

  echo "Ocurrió un problema procesando el pago.";
  // manejar el error 
}

Completar Pago

Éste método permite cobrar fondos previamente retenidos.

• `id`: Identificador único del pago.
• `amount`: Monto por el cual se desea procesar el pago final.

try{
  $api = new Api('<keyId>','<publicKeyId>');

  $respuesta = $api-continuePayment([
    'id' => 'af614bca-0e2b-4232-bc8c-dbedbdf73b48',
    'amount' => '200.00'
  ]);

}catch(\Instapago\Exceptions\InstapagoException $e){
  // manejar errores
}

Información de un Pago

Consulta información sobre un pago previamente generado.

try{
  $api = new Api('<keyId>','<publicKeyId>');

  $idPago = 'af614bca-0e2b-4232-bc8c-dbedbdf73b48';
  
  $respuesta = $api->query($idPago);

}catch(\Instapago\Exceptions\InstapagoException $e){
  // manejar errores
}

Devuelve la misma respuesta que los métodos de crear pagos.

Anular Pago

Este método permite cancelar un pago, haya sido directo o retenido.

try{
  $api = new Api('<keyId>','<publicKeyId>');

  $idPago = 'af614bca-0e2b-4232-bc8c-dbedbdf73b48';

  $info = $api->cancel($idPago);
  
}catch(\Instapago\Exceptions\InstapagoException $e){
  // manejar errores
}

Devuelve la misma respuesta que los métodos de crear pagos.