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

1	import requests
2
3	url = "https://api.koywe.com/api/v1/organizations/organizationId/merchants/merchantId/orders/external/externalId"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

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	}

Authentication

Path parameters

Response

Errors