Métodos de Pago
Aquí encontrarás todos los servicios asociados con nuestra plataforma
Detalles
| Método | Imagen | Método de Pago | Soluciones | 
|---|---|---|---|
| Pix+ | ![]()  | belvo_payment | Open-Finance | 
- Pix+ v1
 - Pix+ v2
 
Como Crear un Pago
POST - https://url.base/api/payment/new
Endpoint para crear un nuevo pago. Para crear una nueva solicitud de pago, 
la solicitud debe  ser construida con los siguientes parámetros.
| Campo | Tipo | Descripción | 
|---|---|---|
| *currency | String | Código de moneda ISO # Países y monedas | 
| *country | String | Formato de país internacional. # Países y monedas | 
| *amount | Integer | Monto de la transacción | 
| *clientName | String | Nombre completo del cliente | 
| *clientEmail | String | Correo electrónico del cliente | 
| *clientPhone | String | Teléfono del cliente | 
| *clientDocument | String | DNI del cliente | 
| *paymentMethod | String | Métodos de pago disponibles Conozca los métodos disponibles para su comercio | 
| *urlConfirmation | Link | Url de confirmación del pago | 
| *urlFinal | Link | Redirección de URL después de completar el pago | 
| *urlRejected | Link | Redirección de URL en caso de rechazo de la transacción | 
| *order | String | Identificador del pago a asociar. El campo "order" debe ser único e irrepetible | 
| *sign | String | La firma de los parámetros es única para cada transacción | 
info
Como recomendación, esta información debería proceder del perfil del cliente.
Ejemplo
{
    $data = [
        "currency" => "BRL",
        "country" => "BR",
        "amount" => 1000,
        "clientName" => "Demo",
        "clientEmail" => "[email protected]",
        "clientPhone" => "999999999",
        "clientDocument" => "33177114692",
        "paymentMethod" => "pix_payment",
        "urlConfirmation" => "webhook",
        "urlFinal" => "url rediret",
        "urlreject" => "url reject",
        "order" => "order id"
        "sing" => "Firma de los parámetros"
        ];
}
Respuesta Crear un pago
La respuesta de ProntoPaga a la solicitud de pago es el UID de la transacción y la URL a la que debe redirigir al usuario .

Ejemplo de Solicitud exitoso
{
    "urlPay"= [string] // Enlace para procesar el pago
    "uid": [string] // Identificador de pago en el sistema
}
Como Crear un Pago
POST - https://url.base/api/payment/v2/new
Endpoint para crear un nuevo pago. Para crear una nueva solicitud de pago, 
la solicitud debe  ser construida con los siguientes parámetros.
| Campo | Tipo | Descripción | 
|---|---|---|
| *currency | String | Código de moneda ISO # Países y monedas | 
| *country | String | Formato de país internacional. # Países y monedas | 
| *amount | Integer | Monto de la transacción | 
| *clientName | String | Nombre completo del cliente | 
| *clientEmail | String | Correo electrónico del cliente | 
| *clientPhone | String | Teléfono del cliente | 
| *clientDocument | String | DNI del cliente | 
| *paymentMethod | String | Métodos de pago disponibles Conozca los métodos disponibles para su comercio | 
| *urlConfirmation | Link | Url de confirmación del pago | 
| *urlFinal | Link | Redirección de URL después de completar el pago | 
| *urlRejected | Link | Redirección de URL en caso de rechazo de la transacción | 
| *order | String | Identificador del pago a asociar. El campo "order" debe ser único e irrepetible | 
| *sign | String | La firma de los parámetros es única para cada transacción | 
info
Como recomendación, esta información debería proceder del perfil del cliente.
Ejemplo
{
    $data = [
        "currency" => "BRL",
        "country" => "BR",
        "amount" => 1000,
        "clientName" => "Demo",
        "clientEmail" => "[email protected]",
        "clientPhone" => "999999999",
        "clientDocument" => "33177114692",
        "paymentMethod" => "pix_payment",
        "urlConfirmation" => "webhook",
        "urlFinal" => "url rediret",
        "urlreject" => "url reject",
        "order" => "order id"
        "sing" => "Firma de los parámetros"
        ];
}
Respuesta Crear un pago
La respuesta de ProntoPaga a la solicitud de pago es el UID de la transacción y un array con las instituciones para mostrar al cliente, de manera que puedan elegir cómo pagar.

Ejemplo exitoso
{
  "institutions"= [Array Data] // Lista de instituciones bancarias
  "uid"= [String] // Identificador de pago en el sistema
}
Selección de institución de pago
Una vez que el cliente selecciona el banco, deben enviar el id de la institución y el uid del pago.
POST - https://url.base/api/payment/v2/start
Endpoint para iniciar el pago.
| Campo | Tipo | Descripción | 
|---|---|---|
| *id_institution | String | Id institución bancaria seleccionada | 
| *uid | String | Uid del pago | 
Response
{
  "url_bank_payment"= [string] // Url institución bancaria
  "uid"= [String] // Identificador de pago en el sistema
}
