# Registrar transacción

Permite a la red registrar la transacción de pago en Payvalida; una vez recibida esta petición correctamente, la referencia se considera aprobada. Antes de invocar esta operación, la red debe hacer las validaciones de negocio pertinentes, algunos ejemplos son: usuario cuenta con saldo suficiente para la transacción o validar un monto mínimo de la transacción.

{% hint style="success" %}
Sandbox: **<https://api-test.payvalida.com/v4/recaudo/dinamico/recaudoregister>**
{% endhint %}

{% hint style="warning" %}
*Los campos marcados con asteriscos (\*) son **obligatorios**.*
{% endhint %}

<mark style="color:green;">`POST`</mark> `https://api.payvalida.com/v4/recaudo/dinamico/recaudoregister`

#### Request Body

| Name                                                 | Type    | Description                                                                                                                                                                                                                                                  |
| ---------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| netname<mark style="color:red;">\*</mark>            | string  | Nombre de identificación única de la Red de Recaudo                                                                                                                                                                                                          |
| request\_type<mark style="color:red;">\*</mark>      | integer | Utilizado en el método de consulta. Valor debe ser 1. En caso de que por el contexto la red necesite definir opciones que permitan definir criterios podemos usar este valor, por ejemplo definir:  1-Abono capital, 2-Reducción cuota                       |
| reference<mark style="color:red;">\*</mark>          | string  | Utilizado en el método de consulta                                                                                                                                                                                                                           |
| reference\_aux                                       | string  | Utilizado en el método de consulta                                                                                                                                                                                                                           |
| payment\_reference<mark style="color:red;">\*</mark> | string  | Referencia de pago, recibida dentro del listado de opciones posibles a pagar.                                                                                                                                                                                |
| transaction<mark style="color:red;">\*</mark>        | string  | ID transacción único de la Red de recaudo. Puede ser el mismo utilizado en la consulta.                                                                                                                                                                      |
| amount<mark style="color:red;">\*</mark>             | number  | Valor a recaudar. No incluir más de 4 decimales.                                                                                                                                                                                                             |
| checksum<mark style="color:red;">\*</mark>           | string  | Cadena de comprobación, calculada con SHA512(netname + reference + trasaction + amount + FIXED\_HASH). Para este cálculo el "amount" se incluye sin decimales.                                                                                               |
| commerce                                             | string  | Nombre del comercio sobre el cual se está realizando la transacción                                                                                                                                                                                          |
| timestamp<mark style="color:red;">\*</mark>          | number  | Fecha en formato Unix segundos.                                                                                                                                                                                                                              |
| teller<mark style="color:red;">\*</mark>             | string  | Código de la tienda/punto en dónde se realiza la transacción (ip o punto de venta)                                                                                                                                                                           |
| terminal\_code                                       | string  | Código de la terminal en dónde se realiza la transacción                                                                                                                                                                                                     |
| geographic\_code<mark style="color:red;">\*</mark>   | string  | Hace referencia al código postal de la localidad en dónde se realiza la transacción, depende de la red/país que lo invoque. En Colombia se conoce como código DANE.                                                                                          |
| key\_value<mark style="color:red;">\*</mark>         | string  | Utilizado en el método de consulta. Valor debe ser 1. En caso de que por el contexto la red necesite incluir posible configuración o condición especial que se deba tener en cuenta en la transacción se puede enviar una cadena con estructura llave-valor. |
| money<mark style="color:red;">\*</mark>              | string  | Código de moneda de la transacción. Formato ISO                                                                                                                                                                                                              |
| name                                                 | string  | Nombre del depositante                                                                                                                                                                                                                                       |
| lastname1                                            | string  | Primer apellido del depositante                                                                                                                                                                                                                              |
| lastname2                                            | string  | Segundo apellido del depositante                                                                                                                                                                                                                             |

{% tabs %}
{% tab title="200 code:  0000 cuando la respuesta sea exitosa.
text: Descripción del error, "OK" cuando la respuesta sea exitosa
transaction\_cost: Costo de la transacción, solo a nivel informativo
amount: Valor aceptado de recaudo
description: Descripción general del comercio en la acptación del recaudo
payment\_reference: Referencia de pago.
transaction: Confirmación ID única de la transacción de la Red
pv\_order: Código de la orden en Payvalida
commerce: Nombre del comercio asociado al pago
timestamp: Fecha en formato Unix segundos.
authorization\_code: Código de autorización entregado por el comercio.
checksum: Cadena de comprobación, calculada con SHA512(timestamp + amount + FIXED\_HASH). Solo se calcula cuando Body/data no es vacío. Para este cálculo el "amount" se incluye sin decimales." %}

```
{
    "code":"0000",
    "description": "OK",
    "data": {
        "transaction_cost":3000,
        "amount":50000,
        "descripcion":"",
        "payment_reference":"98383899901",
        "transaction":"237883993939",
        "pv_order": "2929299001",
        "commerce":"kuanto",
        "timestamp": 1618641323,
        "authorization_code":"IUSYY8899",
        "checksum":"a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
    }
}
```

{% endtab %}
{% endtabs %}