> 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

## 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payvalida.com/apipse/ordenes-de-pse/registrar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.