> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/apipse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/apipse/ordenes-de-pse/registrar.md).

# Registrar

Permite registrar una transacción en PSE

## Registrar

<mark style="color:green;">`POST`</mark> `https://api.payvalida.com/pse/transactions`

**URL Sandbox:** *<https://api-test.payvalida.com/pse/transactions>*  \
\
Al crear una transacción, se envían los datos necesarios para completar el pago y se obtienen el URL del banco y el ticketid. Para completar la transacción se debe redireccionar al cliente al URL del banco para que éste complete la operación. Con el ticketid se consulta el resultado de la operación. Es prudente esperar de 5 a 10 minutos entre la creación de la transacción y la consulta, tiempo suficiente para que el cliente complete la operación con su entidad bancaria.

#### Request Body

| Name        | Type   | Description                                                                     |
| ----------- | ------ | ------------------------------------------------------------------------------- |
| merchant    | string | Identificación del comercio en Payvalida. Máx. 50 caracteres.                   |
| serviceCode | string | Código de servicio del comercio en PSE. Máx. 10 caracteres.                     |
| checksum    | string | Cadena de comprobación con SHA512(reference + amount + di + bank + FIXED\_HASH) |
| bank        | string | Código del banco en PSE. 4 caracteres                                           |
| amount      | string | Monto de la orden de compra.                                                    |
| reference   | string | Número de referencia en Payvalida. Máx. 16 caracteres.                          |
| di          | string | Número de documento del comprador. Máx 15 caracteres                            |
| typeDI      | string | Tipo de documento de identidad del comprador. Máx. 3 caracteres.                |
| name        | string | Nombres del comprador. Máx. 25 caracteres.                                      |
| email       | string | Correo electrónico del comprador. Máx. 50 caracteres.                           |
| phone       | string | Número de teléfono del comprador. Máx. 10 números.                              |
| address     | string | Dirección de residencia del comprador. Máx. 64 caracteres.                      |
| urlReturn   | string | URL de retorno después de finalizada transacción en PSE. Máx. 300 caracteres.   |
| personType  | string | Tipo de persona que realiza la compra. "N" natural o "J" jurídica               |
| lastName    | string | Apellidos del comprador. Máx. 25 caracteres.                                    |

{% tabs %}
{% tab title="200 La ejecución retorna un JSON estructurado de la siguiente manera:" %}

```
{  
   "CODE":"0000",
   "DESC":"Consulta Exitosa",
   "DATA":[  
      {  
         "URL_BANK":"desarrollo.bancolombia.com",
         "TICKET_ID":"00946981"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

#### Detalles

* **serviceCode:** código de servicio de Payvalida o del comercio en PSE.
* **bank:** se consigue de la [lista de bancos](/apipse/ordenes-de-pse/lista-de-bancos.md).
* **reference:** se genera utilizando el [API de recaudos](https://docs.payvalida.com/api-recaudo/).&#x20;
* **amount:** monto de la operación. El monto de la orden en Payvalida debe de coincidir con este.
* **urlReturn:** esta url es donde va a redireccionar el cliente cuando termine su operación en PSE.
* **name:** nombre del cliente en el documento de identidad (no acepta caracteres especiales ni acentos).
* **typeDI:** los valores válidos son "CC", "CE", "NIT", "TI", "PP", "TE", "RC", "DIE"
* **personType:** se permite tanto personas naturales como jurídicas.
* **token**: Es el token JWT con la orden completa encriptada&#x20;

{% hint style="success" %}
La identificación del comercio (merchant) y FIXED\_HASH, es generada al momento de [crear una cuenta](https://registro.payvalida.com) en nuestra plataforma y se envía por correo electrónico. El service code y el entity code son entregados luego de configurar el comercio para utilizar PSE.&#x20;
{% endhint %}

{% hint style="warning" %}
Para registrar una nueva transacción en PSE sobre la misma referencia se debe de esperar que el estado de la transacción pase de PENDIENTE a FALLIDA o RECHAZADA.
{% endhint %}

{% hint style="info" %}
Si ya utilizabas anteriormente el [**API PSE**](broken://spaces/-MMaFOgRgz1FSwYMKUKD), ten en cuenta que para esta nueva versión se agregaron tres datos del comprador, requeridos en la petición: ***email***, ***phone*** y ***address***.
{% endhint %}