> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-cashout-redes/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/api-cashout-redes/cashout-redes-english/register.md).

# Register

Register a cashout transaction, handing cash to the requester.

{% hint style="info" %}
Method: **POST**
{% endhint %}

{% hint style="success" %}
**Production:** <https://api.payvalida.com/cashout/v1/transaction/{netname}>

**Sandbox:** <https://api-test.payvalida.com/cashout/v1/transaction/{netname}>
{% endhint %}

{% tabs %}
{% tab title="Request" %}

<table><thead><tr><th width="140">Name</th><th width="100">Required</th><th width="214">Description</th><th width="137">Type</th><th>Length</th></tr></thead><tbody><tr><td>idoperation</td><td>Yes</td><td>Operation identifier (obtained from the query)</td><td>Numeric</td><td>15</td></tr><tr><td>netcode</td><td>Yes</td><td>Network code</td><td>Numeric</td><td>20</td></tr><tr><td>transaction</td><td>Yes</td><td>Transaction ID (unique)</td><td>Alphanumeric</td><td>50</td></tr><tr><td>teller</td><td>Yes</td><td>ID of the teller that executed the transaction</td><td>Alphanumeric</td><td>40</td></tr><tr><td>danecode</td><td>Yes</td><td>DANE code **</td><td>Alphanumeric</td><td>50</td></tr><tr><td>checksum</td><td>Yes</td><td>Checksum encoded with SHA512(name + idoperation + transaction + FIXED_HASH)</td><td>Alphanumeric</td><td>512</td></tr></tbody></table>
{% endtab %}

{% tab title="Request (ejemplo)" %}

> curl -i -X POST -H "Content-Type:application/json"\
> -d '{
>
> &#x20;       "idoperation": 1393,
>
> &#x20;       "transaction": "99999999901",
>
> &#x20;       "netcode": 1052,
>
> &#x20;       "teller": "150",
>
> &#x20;       "checksum": "e38aef6c8a604f62c05336457fd0c262b73a5a3028cd414309fea4b1f519f05ccfe9e29b6e21fbf5e9c02999a98003960c71dd89818021ac27faa83da1ce7169"
>
> }' <https://api-test.payvalida.com/cashout/v1/transactions/redEjemplo>
> {% endtab %}

{% tab title="Response" %}

| Nombre               | Descripción                                                                                                                  | Tipo         |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------ |
| code                 | Indicates the resulting code, “0000” means result with no error, any other value indicates the error code.                   | Alphanumeric |
| text                 | Contains the detailed message associated with the code.                                                                      | Alphanumeric |
| data                 | Contains the transaction’s data (when there’s no error)                                                                      | Object       |
| data-amount          | Amount of the transaction (since partial amounts are not allowed, when registering the transaction its amount is confirmed). | Alphanumeric |
| data-transactionCost | Cost assumed by the user for this transaction                                                                                | Alphanumeric |
| data-currency        | Currency registered for this cashout order                                                                                   | Alphanumeric |
| data-description     | Description of the transaction                                                                                               | Alphanumeric |
| data-document        | Confirmation of the document ID                                                                                              | Alphanumeric |
| data-otp             | Confirmation of the OTP sent                                                                                                 | Alphanumeric |
| data-idpayvalida     | Transaction identifier in Payvalida’s system                                                                                 | Alphanumeric |
| data-transaction     | Transaction confirmation as reported by the network                                                                          | Alphanumeric |
| data-checksum        | Checksum encoded with SHA512(transaction + idpayvalida + FIXED\_HASH)                                                        | Alphanumeric |

{% endtab %}

{% tab title="Response (example)" %}

> {
>
> &#x20;       "code":"0000",
>
> &#x20;       “text”:”OK”,
>
> &#x20;       "data":{
>
> &#x20;               "amount":"45000.0",
>
> &#x20;              “transactionCost”:”2000.0”,
>
> &#x20;               "currency":"COP”,
>
> &#x20;               "description":"Retiro dividendos",
>
> &#x20;               "document":"986157352",
>
> &#x20;               “otp”:”1234”,
>
> &#x20;               “idpayvalida”:”998563”,
>
> &#x20;               “checksum”: ”wff88nfd99e52b735c67df2c1945b68w4r34wf4t989jc0pl...”
>
> &#x20;       }
>
> }
> {% endtab %}
> {% endtabs %}

{% hint style="info" %}
\*\* If your integration is outside Colombia, you have to send the **zip code** in the parameter **danecode**
{% endhint %}