Skip to main content

Document Types

Deprecated. This endpoint remains functional for backwards compatibility but is no longer the recommended approach. The POST /orders response now includes an allowed_documents field with the same data. See Creating Orders for details.
All direct API orders require a national ID number (id_number) and document type (id_type) for buyer identification and compliance. Use this endpoint to retrieve the valid document types for a given country.

Request

Response

How to use

Pass the id_national_document_type value as the id_type field in the shopper object when creating orders:
The id_type field currently accepts the integer ID from this endpoint. The API also accepts id_national_document_type as an alias for id_type.

Gateway-specific restrictions

Not all gateways accept all document types. When creating an order, ensure the document type is supported by the selected gateway:
Sending an unsupported document type for Daviplata or Breb will result in a payment error from the gateway.

Supported countries

Additional countries will be added as Wava expands across Latin America.