Cierre del pedido POST

Ver el cobro del pedido


                    POST /api/checkout/get-payment

Descripción

Devuelve la cuenta del pedido, los medios para pagarla y en qué va el cobro en línea.

Detalles

Retorna el pedido con sus productos, totales y saldo por pagar, los medios de pago en línea que acepta el restaurante con sus enlaces legales, el último intento de cobro y a nombre de quién sale la factura. Si el restaurante no cobra en línea, no trae medios.

Permisos requeridos

auth-order

Request

Este endpoint no recibe parámetros.

Respuesta

Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.

Campo	Tipo	Descripción
order	object	La cuenta del pedido
order.orderUuid	string	Identificador del pedido
order.orderCode	string	Número del pedido para mostrar
order.placeName	string Admite vacío	Mesa, habitación o canal del pedido
order.lifecycleStatus	string	Estado del pedido
order.paymentStatus	string	Estado del pago del pedido
order.currency	string	Moneda del restaurante
order.productsCents	int	Productos, en centavos
order.discountCents	int	Descuento, en centavos
order.tipCents	int	Propina, en centavos
order.deliveryFeeCents	int	Domicilio, en centavos
order.totalCents	int	Total del pedido, en centavos
order.paidCents	int	Lo que ya se pagó, en centavos
order.balanceCents	int	Lo que falta pagar, en centavos
order.hasBillableItems	bool	Si el pedido ya tiene productos para cobrar
items	array	Productos del pedido
items[].productName	string	Nombre del producto
items[].optionName	string Admite vacío	Variación elegida
items[].quantity	decimal	Cantidad
items[].priceCents	int	Precio de la línea, en centavos
gateway	object Admite vacío	Pago en línea del restaurante; vacío si no cobra en línea
gateway.privacyPolicyUrl	string Admite vacío	Términos de la pasarela
gateway.personalDataUrl	string Admite vacío	Autorización de datos personales
gateway.enabledMethods	array<string>	Medios de pago en línea que acepta
transaction	object Admite vacío	Último cobro en línea del pedido; vacío si nunca se intentó pagar
transaction.paymentTransactionUuid	string	Identificador del cobro
transaction.methodType	string Admite vacío	Medio con que se envió el pago
transaction.status	string	Estado del cobro en la pasarela
transaction.isSent	bool	Si ya se envió a la pasarela
transaction.amountInCents	int	Monto del cobro, en centavos
transaction.asyncPaymentUrl	string Admite vacío	Dirección del banco para terminar el pago
transaction.reference	string	Referencia del cobro
transaction.statusMessage	string Admite vacío	Motivo que dio el banco
transaction.updatedAt	datetime	Último cambio del cobro
invoiceRecipient	object Admite vacío	A nombre de quién sale la factura; vacío si es consumidor final
invoiceRecipient.name	string	Nombre o razón social
invoiceRecipient.documentTypeCode	string Admite vacío	Tipo de documento
invoiceRecipient.documentNumber	string	Número de documento

Ejemplo de request

curl -X POST https://restofy.pro/api/checkout/get-payment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z

HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "order": {
            "orderUuid": "6f8d466d-b9bf-4942-9228-cbf7969afd18",
            "orderCode": "62W-C56",
            "placeName": "Mesa 01",
            "lifecycleStatus": "open",
            "paymentStatus": "unpaid",
            "currency": "COP",
            "productsCents": 2300000,
            "discountCents": 0,
            "tipCents": 0,
            "deliveryFeeCents": 0,
            "totalCents": 2300000,
            "paidCents": 0,
            "balanceCents": 2300000,
            "hasBillableItems": true
        },
        "items": [
            {
                "productName": "Cazuela de Mariscos",
                "optionName": null,
                "quantity": 1,
                "priceCents": 2300000
            }
        ],
        "gateway": {
            "privacyPolicyUrl": "https://wompi.co/legal/stub-privacy",
            "personalDataUrl": "https://wompi.co/legal/stub-personal-data",
            "enabledMethods": [
                "NEQUI",
                "BANCOLOMBIA_TRANSFER",
                "PSE",
                "DAVIPLATA"
            ]
        },
        "transaction": {
            "paymentTransactionUuid": "a8c04b41-7275-40c7-b175-60d669647259",
            "methodType": "NEQUI",
            "status": "PENDING",
            "isSent": true,
            "amountInCents": 2300000,
            "asyncPaymentUrl": null,
            "reference": "a8c04b41-7275-40c7-b175-60d669647259",
            "statusMessage": null,
            "updatedAt": "2026-10-09T01:58:59.000Z"
        },
        "invoiceRecipient": null
    }
}

Volver a Cierre del pedido