> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirmar una orden

> Confirma una orden desde tu lado: marca como pagada una orden con pago manual o completa una orden de off-ramp ya pagada. El efecto depende de orderType.

Llama a este endpoint para confirmar una orden desde tu lado. Lo que hace depende de `orderType` y, en las órdenes `fiat_to_fiat`, de `direction` (`on_ramp` u `off_ramp`), que es obligatorio para ese tipo:

| `orderType` | `direction` | Efecto | Se acepta cuando |
| - | - | - | - |
| `fiat_to_crypto` | — | Marca la orden como pagada (`status: 50`) después de que enviaste el fiat. | La orden está en `status: 40` y usa un método de pago manual. Si la orden muestra `status: 31`, primero sube los documentos requeridos. |
| `crypto_to_fiat` | — | Completa la orden (`status: 60`). | La orden está en `status: 50`. |
| `fiat_to_fiat` | `on_ramp` | Marca el tramo de on-ramp como pagado después de que enviaste el fiat. | La orden está en `status: 41`, usa un método de pago manual de on-ramp, no se ha confirmado antes y ya se subieron los documentos de soporte requeridos, si los hay. |
| `fiat_to_fiat` | `off_ramp` | Sin efecto; devuelve `true`. | Siempre. |

Para `fiat_to_crypto` y `crypto_to_fiat`, la acción sigue el tipo real de la orden. Las órdenes con métodos de pago automáticos pasan a pagadas mediante la integración bancaria de VelaFi y no se pueden marcar como pagadas a través de este endpoint.

## Endpoint

```text theme={null}
POST https://api.velafi.com/v2/order/confirm
```

> [!NOTE]
>
> Usa `https://api-test.velafi.com/v2/order/confirm` para pruebas en sandbox.

## Encabezados de la solicitud

| Encabezado | Valor |
| - | - |
| `X-BH-TOKEN` | Tu token de `GET /v2/token/generate` |
| `Content-Type` | `application/json` |

## Parámetros del cuerpo de la solicitud

**orderId** `integer` *required*

El ID numérico único de la orden que quieres confirmar.

**orderType** `string` *required*

El tipo de la orden. Debe ser `fiat_to_crypto`, `crypto_to_fiat` o `fiat_to_fiat`.

**direction** `string`

Obligatorio solo cuando `orderType` es `fiat_to_fiat`. Indica qué tramo confirmar: `on_ramp` u `off_ramp`.

## Campos de la respuesta

**code** `integer`

Código de estado de la respuesta. `200` indica éxito.

**msg** `string`

Mensaje de respuesta legible.

**data** `boolean`

`true` si la orden se confirmó correctamente.

## Ejemplos

> [tab] Orden de cripto a fiat
>
> ```bash theme={null}
> curl -X POST "https://api.velafi.com/v2/order/confirm" \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "orderId": 1123123123,
>     "orderType": "crypto_to_fiat"
>   }'
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": true
> }
> ```

> [tab] Orden de fiat a fiat (tramo de on-ramp)
>
> ```bash theme={null}
> curl -X POST "https://api.velafi.com/v2/order/confirm" \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "orderId": 493829236956962817,
>     "orderType": "fiat_to_fiat",
>     "direction": "on_ramp"
>   }'
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": true
> }
> ```

> [!WARNING]
>
> Las solicitudes que no cumplen las condiciones de la tabla anterior devuelven un error. Consulta el estado actual de la orden con `GET /v2/order/detail` antes de llamar a este endpoint.


## Related topics

- [Códigos de error](https://docs.velafi.com/es/docs/error-codes.md)
- [Obtener una orden](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order.md)
- [Subir documentos de una orden](https://docs.velafi.com/es/api-reference/order/upload-invoice-documents-for-a-specific-order.md)
- [Crear una orden de on-ramp](https://docs.velafi.com/es/api-reference/order/create-a-fiat-to-crypto-order.md)
- [Crear una orden de off-ramp](https://docs.velafi.com/es/api-reference/order/create-a-crypto-to-fiat-order.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.