PedidosPedidos
Registrar pago del pedido
Registra un pago con método, moneda e importe, y devuelve el pedido actualizado.
Parámetros de ruta
orderId*string
Identificador del pedido.
Parámetros de cabecera
x-Store-Id?string
Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.
Cuerpo de la solicitud
application/json
Definiciones TypeScript
Usa esta definición en TypeScript.
Cuerpo de la respuesta
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.ecomiq.pe/api/v1/orders/7204558912004325350/payments" \ -H "x-Store-Id: <store-id>" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "method": "Mi tienda", "currencyCode": "PEN", "amount": 178, "idempotencyKey": "pedido-2026-0001", "reference": "Frente al parque Kennedy." }'{ "id": "7204558912004325350", "storeId": "7204558912004327977", "cartId": "7204558912004325176", "orderDraftId": "7204558912004324619", "customerId": "7204558912004326262", "orderNumber": "ORD-2026-0001", "orderShortId": "7204558912004321350", "couponCode": "BIENVENIDA10", "origin": "checkout", "sourceIdentifier": "ERP-0001", "orderGroup": "ORD-2026-0001", "notes": "Entregar después de las 18:00.", "phone": "+51987654321", "email": "andrea.ramos@example.com", "firstName": "Andrea", "lastName": "Ramos", "identificationType": "DNI", "identificationNumber": "45678912", "entityTaxId": "7204558912004326352", "entityName": "Comercial Lima SAC", "promotion": "Bienvenida 10 %", "shippingPromotion": "Envío gratis desde S/ 150", "totalSkus": 24, "shippingConnectionId": "7204558912004329148", "orderDate": "2026-09-28T15:30:00Z", "preOrderDate": "2026-09-28T15:30:00Z", "confirmedAt": "2026-09-28T15:30:00Z", "inProgressAt": "2026-09-28T15:30:00Z", "paymentAt": "2026-09-28T15:30:00Z", "shippingAt": "2026-09-28T15:30:00Z", "closedAt": "2026-09-28T15:30:00Z", "cancelledAt": "2026-09-28T15:30:00Z", "completedAt": "2026-09-28T15:30:00Z", "conciliationAt": "2026-09-28T15:30:00Z", "invoicedAt": "2026-09-28T15:30:00Z", "inTransitAt": "2026-09-28T15:30:00Z", "pickupAt": "2026-09-28T15:30:00Z", "returnedAt": "2026-09-28T15:30:00Z", "invalidAt": "2026-09-28T15:30:00Z", "status": "new", "state": "open", "fulfillmentStatus": "unfulfilled", "returnStatus": "none", "shippingType": "delivery", "invoiceType": "ticket", "sellerId": "7204558912004323447", "tags": "algodón", "integrationTags": "erp", "cancelReason": "Reposición de stock.", "cancelReasonType": "Reposición de stock.", "currencyCode": "PEN", "subTotal": 178, "discount": 10, "shipping": 1, "extraShippingCost": 40, "tax": 1, "warranty": 1, "total": 178, "assignee": { "memberId": "7204558912004324722", "name": "Andrea Ramos", "email": "andrea.ramos@example.com" }, "attachments": "https://mi-tienda.ecomiq.app/files/guia-de-tallas.pdf", "invoiceNumber": "F001-00012345", "invoiceLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon", "isSplitSellerItem": false, "hasRefund": false, "hasPaymentToConfirm": false, "hasTrackingNumber": true, "billingAddress": { "address1": "Av. Larco 1234", "city": "Lima", "countryCode": "PE", "name": "Mi tienda", "company": "Comercial Lima SAC", "address2": "Dpto. 501", "province": "Lima", "postalCode": "15074" }, "shippingAddress": { "address1": "Av. Larco 1234", "city": "Lima", "countryCode": "PE", "name": "Mi tienda", "company": "Comercial Lima SAC", "address2": "Dpto. 501", "province": "Lima", "postalCode": "15074" }, "attribution": { "campaignId": "7204558912004328792", "utmSource": "instagram", "utmMedium": "social", "utmCampaign": "nueva-temporada", "referralCode": "AMIGA10" }, "instructions": { "giftMessage": "¡Feliz cumpleaños, Andrea!", "specialInstructions": "20123456789" }, "items": [ { "id": "7204558912004325350", "externalItemId": "7204558912004323678", "productId": "7204558912004322039", "categoryId": "7204558912004327982", "brandId": "7204558912004322959", "sellerId": "7204558912004323447", "shippingProfileId": "7204558912004329819", "variantId": "7204558912004323197", "skuId": "7204558912004326949", "sku": "POL-001-AZ-M", "locationId": "7204558912004328277", "title": "Polo de algodón", "subtitle": "Polo de algodón", "thumbnail": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp", "productTitle": "Polo de algodón", "productDescription": "Polo de algodón pima para uso diario.", "productType": "product", "productCollection": "nueva-temporada", "productHandle": "polo-de-algodon", "variantSku": "POL-001-AZ-M", "variantBarcode": "7751234567892", "variantTitle": "Polo de algodón", "variantOptionValues": {}, "brand": "Andina", "category": "Polos", "height": 30, "length": 30, "width": 30, "weight": 0.3, "weightUnit": "kilogram", "quantity": 2, "quantityRemaining": 2, "quantityToDispatch": 2, "quantityDispatched": 2, "quantityDelivered": 2, "quantityRefunded": 2, "quantityReturned": 2, "unitPrice": 89, "subTotal": 178, "discount": 10, "shipping": 1, "tax": 1, "warranty": 1, "total": 178, "sellerCommissionId": "7204558912004322946", "commissionSource": "seller", "productCommissionPercent": 10, "freightCommissionPercent": 10, "fixedFee": 1, "commissionBaseAmount": 178, "productCommissionAmount": 178, "freightCommissionBaseAmount": 178, "freightCommissionAmount": 178, "commissionAmount": 178, "requiresShipping": false, "isDiscountable": false, "isGiftcard": false, "isTaxInclusive": false, "isCustomPrice": false, "shippingConnectionId": "7204558912004329148", "shippingProviderName": "Polo de algodón", "shippingCostId": "7204558912004324587", "shippingCostName": "Polo de algodón", "invoiceNumber": "F001-00012345", "invoiceLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon", "trackingNumber": "PE1234567890", "trackingLink": "https://tracking.example.com/PE1234567890", "orderItemStatus": "new", "inProgressAt": "2026-09-28T15:30:00Z", "paymentAt": "2026-09-28T15:30:00Z", "shippingAt": "2026-09-28T15:30:00Z", "closedAt": "2026-09-28T15:30:00Z", "cancelledAt": "2026-09-28T15:30:00Z", "completedAt": "2026-09-28T15:30:00Z", "conciliationAt": "2026-09-28T15:30:00Z", "invoicedAt": "2026-09-28T15:30:00Z", "inTransitAt": "2026-09-28T15:30:00Z", "pickupAt": "2026-09-28T15:30:00Z", "returnedAt": "2026-09-28T15:30:00Z", "deliveredAt": "2026-09-28T15:30:00Z", "modifiers": [ { "id": "7204558912004325350", "modifierGroupId": "7204558912004324624", "modifierGroupName": "Personalización", "modifierOptionId": "7204558912004327012", "modifierOptionName": "Bordado", "value": "Mi tienda", "quantity": 2, "priceDelta": 89 } ], "metadata": {}, "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z" } ], "shippingMethods": [ { "id": "7204558912004325350", "name": "Mi tienda", "description": "Polo de algodón pima para uso diario.", "subtotal": 178, "discountTotal": 178, "taxTotal": 178, "total": 178, "isTaxInclusive": false, "sellerId": "7204558912004323447", "shippingProfileId": "7204558912004329819", "shippingMethodId": "7204558912004325207", "connectionId": "7204558912004329542", "providerName": "Courier Lima", "trackingCode": "PE1234567890", "estimatedDays": 30, "zoneCode": "LIMA", "locationId": "7204558912004328277", "pickupPointId": "7204558912004324876", "scheduledDate": "2026-09-28", "scheduledTime": "09:00:00", "data": {} } ], "payments": [ { "id": "7204558912004325350", "paymentMethod": "Tarjeta de crédito", "paymentCode": "card", "amount": 178, "cardNumber": "Mi tienda", "cardType": "visa", "installments": 1, "authorizationCode": "POL-001", "transactionReference": "Frente al parque Kennedy.", "providerId": "7204558912004329705", "paymentTransactionId": "7204558912004324696", "paymentStatus": "Mi tienda", "receiptUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon", "metadata": {}, "refundedAmount": 178, "refundableAmount": 178 } ], "trackings": [ { "id": "7204558912004325350", "orderItemId": "7204558912004328121", "title": "Polo de algodón", "content": "Gracias por tu compra, Andrea.", "type": "note", "userId": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821", "email": "andrea.ramos@example.com", "ip": "203.0.113.10", "createdOn": "2026-09-28T15:30:00Z", "createdBy": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821" } ], "packageItems": [ { "id": "7204558912004325350", "carrierId": "Courier Lima", "carrierName": "Courier Lima", "trackingNumber": "PE1234567890", "trackingLink": "https://tracking.example.com/PE1234567890", "orderItemId": "7204558912004328121", "sku": "POL-001-AZ-M", "packages": 1, "weight": 0.3, "quantity": 2, "serviceType": "Estándar", "serviceCost": 40, "from": "ventas@example.com", "to": "andrea.ramos@example.com", "partialTracking": true, "invoiceNumber": "F001-00012345", "packageType": "delivery", "packageStatus": "readyToPickUp", "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z" } ], "transactions": [ { "id": "7204558912004325350", "type": "in", "amount": 178, "paymentMethod": "Tarjeta de crédito", "referenceId": "7204558912004328363", "referenceType": "paymentTransaction", "transactionReference": "Frente al parque Kennedy.", "transactionReferenceDocumentLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon", "content": "Gracias por tu compra, Andrea.", "createdOn": "2026-09-28T15:30:00Z", "createdBy": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821" } ], "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z", "financialSummary": { "paidAmount": 178, "refundedAmount": 178, "balanceDue": 1, "refundableAmount": 178, "shippingRefundedAmount": 178, "shippingRefundableAmount": 178, "refundDue": 1 }}