BillingPaymentsCrypto
BillingPaymentsCrypto
  • Getting Started
    • 👋 Welcome
    • 🔑 Sandbox credentials
    • 🏁 Getting Started
    • 📨 Webhooks
  • Payments API Reference
LogoLogo
Payments API ReferenceOrders

GET
/api/v1/organizations/:organizationId/merchants/:merchantId/orders/external/:externalId
GET
/api/v1/organizations/:organizationId/merchants/:merchantId/orders/external/:externalId
1curl https://api.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/orders/external/externalId \
2     -H "Authorization: Bearer <token>"
Try it
200Retrieved
1{
2  "id": "ord_123456789",
3  "type": "PAYIN",
4  "destinationAccountId": "bank-account-123",
5  "originAccountId": "bank-account-456",
6  "originCurrencySymbol": "COP",
7  "destinationCurrencySymbol": "COP",
8  "amountIn": 1000000,
9  "amountOut": 900000,
10  "dueDate": "2026-01-28T12:36:55.523694Z",
11  "description": "Payment for invoice #1234",
12  "externalId": "payin-ext-001",
13  "paymentMethods": [
14    {
15      "method": "PSE",
16      "extra": {
17        "bankAccount": {
18          "name": "BANCOLOMBIA"
19        },
20        "phone": {
21          "countryCode": "+57",
22          "number": "3178901234"
23        },
24        "email": "string"
25      }
26    }
27  ],
28  "quoteId": "quote-123",
29  "contactId": "contact-123",
30  "enforcedDocument": "45676946",
31  "sendEmail": true,
32  "sendNotification": true,
33  "sendWhatsapp": true,
34  "sendReminders": true,
35  "providedAction": "https://checkout.row.com/order/123456789",
36  "providedActionType": "QR",
37  "createdAt": "2025-09-22T19:51:06.138Z",
38  "status": "DRAFT"
39}
Was this page helpful?
Previous

Create a quote

Next
Built with
Retrieves a specific order by its external ID (merchant-provided identifier). The order must belong to the merchant and the merchant must belong to the organization.
Get an order by external ID

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

merchantIdstringRequired
Merchant ID
organizationIdstringRequired
Organization ID
externalIdstringRequired
External ID (merchant-provided identifier)

Response

Order retrieved successfully
idstring
Unique order ID
typeenum
Type of order
destinationAccountIdstring

Destination account ID (bank or wallet)

originAccountIdstring or null

Origin account ID (bank or wallet)

originCurrencySymbolstring
Origin currency symbol
destinationCurrencySymbolstring
Destination currency symbol
amountIndouble
Amount in origin currency
amountOutdouble
Amount in destination currency
dueDatestring
Due date for payment links. If not provided during creation, defaults to 24 hours from order creation. Cannot exceed the maximum allowed lifetime.
descriptionstring
Description of the order
externalIdstring

External ID (idempotent identifier)

paymentMethodslist of objects
Payment methods used
quoteIdstring
Quote ID used for currency conversion
contactIdstring
Contact ID identifying the counterparty to whom this order is directed. This represents the entity on the other side of the transaction.
enforcedDocumentstring
National ID document (e.g. DNI, RUT, Cédula) that must be provided to complete the order
sendEmailboolean
Whether email notifications are enabled
sendNotificationboolean
Whether in-app notifications are enabled
sendWhatsappboolean
Whether WhatsApp notifications are enabled
sendRemindersboolean
Whether order reminders are enabled
providedActionstring
Action URL or data provided to the user to complete the order, such as a QR code, payment link, or other actionable payment method
providedActionTypeenum
Type of provided action
Allowed values:
createdAtstring
Timestamp when the order was created
statusenum
Current status of the order

Errors

Order retrieved successfully

National ID document (e.g. DNI, RUT, Cédula) that must be provided to complete the order

Whether in-app notifications are enabled

Retrieves a specific order by its external ID (merchant-provided identifier). The order must belong to the merchant and the merchant must belong to the organization.

External ID (merchant-provided identifier)