Skip to main content

​
Document Types

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

curl -X GET "https://api.wava.co/v1/national-document-types/CO" \
  -H "merchant-key: YOUR_MERCHANT_KEY"

​
Response

{
  "data": [
    {
      "id_national_document_type": 1,
      "country_code": "CO",
      "type": "CC",
      "description": "Cédula de Ciudadanía"
    },
    {
      "id_national_document_type": 2,
      "country_code": "CO",
      "type": "CE",
      "description": "Cédula de Extranjería"
    },
    {
      "id_national_document_type": 3,
      "country_code": "CO",
      "type": "TI",
      "description": "Tarjeta de Identidad"
    }
  ]
}

​
How to use

Pass the id_national_document_type value as the id_type field in the shopper object when creating orders: 
"shopper": {
  "id_number": "12345678",
  "id_type": 1
}
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:
GatewayAccepted document types
NequiAll Colombian document types (CC, CE, TI, etc.)
DaviplataCC, CE, TI only
BrebCC, CE, TI only
Sending an unsupported document type for Daviplata or Breb will result in a payment error from the gateway.

​
Supported countries

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