> ## Documentation Index > Fetch the complete documentation index at: https://docs.vitawallet.io/llms.txt > Use this file to discover all available pages before exploring further. # Payment Methods by Country > **GET /api/businesses/payment_methods/{country_iso_code}** Returns available payment methods for a specific country with their required fields. This endpoint is essential for implementing direct payments without checkout redirection. #### Purpose This endpoint allows businesses to: - Query payment methods available in each country - Get required fields for each payment method - Build dynamic payment forms in their own interface - Avoid redirecting customers to external checkout #### Parameters | Parameter | Type | Description | | --- | --- | --- | | `country_iso_code` | string (required) | ISO 3166-1 alpha-2 country code (AR, CL, CO, MX, BR) | #### Authentication Headers All requests must include HMAC-SHA256 authentication headers: | Header | Type | Description | | --- | --- | --- | | `x-login` | string (required) | Business API login | | `x-trans-key` | string (required) | Business API transaction key | | `x-date` | string (required) | ISO8601 DateTime (2024-01-15T10:30:00Z) | | `Authorization` | string (required) | V2-HMAC-SHA256, Signature:{signature} | | `Content-Type` | string (required) | application/json | #### Response Structure Successful response includes: - Array of payment methods available in the country - Required fields for each method with validation rules - Field types (text, select, phone, email) - Available options for select fields (banks, document types) #### Supported Countries - **Argentina (AR)**: CVU, QR - **Bolivia (BO):** QR Transfer - **Brasil (BR)**: QR PIX - **Chile (CL)**: Webpay, Fintoc - **Colombia (CO)**: BreB Transfer, PSE, Nequi, Daviplata, Bancolombia. - **México (MX)**: CLABE Transfer #### Error Codes | Status | Code | Description | Solution | | --- | --- | --- | --- | | 400 | 305 | Invalid country_iso_code | Use valid ISO codes: AR, CL, CO, MX, BR | | 401 | 303 | Invalid signature | Check HMAC-SHA256 generation | | 401 | 301 | Missing authentication header | Include all required headers | | 404 | 404 | Country not supported | Verify country is in supported list | | 500 | 500 | Internal server error | Contact support if persists | ## OpenAPI ````yaml /openapi.yaml get /api/businesses/payment_methods/{country_iso_code} openapi: 3.0.0 info: title: Vita Business API description: >- Vita Wallet Business API — integra payins, payouts, exchange, transactions, users y webhooks para operar pagos en LatAm y el mundo. version: 1.0.0 contact: name: Vita Wallet Support url: https://vitawallet.io email: empresas@vitawallet.io servers: - url: https://api.vitawallet.io description: Production - url: https://api.stage.vitawallet.io description: Sandbox security: - xLogin: [] xTransKey: [] xDate: [] hmacSignature: [] tags: - name: Create Payin - name: Direct Payment - name: Exchange - name: Vita Sent - name: Bank Payouts - name: External Crypto Payouts - name: Transactions - name: Users Creation - name: User Information - name: Webhooks externalDocs: url: https://vitawallet.io description: Vita Wallet paths: /api/businesses/payment_methods/{country_iso_code}: get: tags: - Direct Payment summary: Payment Methods by Country description: >- **GET /api/businesses/payment_methods/{country_iso_code}** Returns available payment methods for a specific country with their required fields. This endpoint is essential for implementing direct payments without checkout redirection. #### Purpose This endpoint allows businesses to: - Query payment methods available in each country - Get required fields for each payment method - Build dynamic payment forms in their own interface - Avoid redirecting customers to external checkout #### Parameters | Parameter | Type | Description | | --- | --- | --- | | `country_iso_code` | string (required) | ISO 3166-1 alpha-2 country code (AR, CL, CO, MX, BR) | #### Authentication Headers All requests must include HMAC-SHA256 authentication headers: | Header | Type | Description | | --- | --- | --- | | `x-login` | string (required) | Business API login | | `x-trans-key` | string (required) | Business API transaction key | | `x-date` | string (required) | ISO8601 DateTime (2024-01-15T10:30:00Z) | | `Authorization` | string (required) | V2-HMAC-SHA256, Signature:{signature} | | `Content-Type` | string (required) | application/json | #### Response Structure Successful response includes: - Array of payment methods available in the country - Required fields for each method with validation rules - Field types (text, select, phone, email) - Available options for select fields (banks, document types) #### Supported Countries - **Argentina (AR)**: CVU, QR - **Bolivia (BO):** QR Transfer - **Brasil (BR)**: QR PIX - **Chile (CL)**: Webpay, Fintoc - **Colombia (CO)**: BreB Transfer, PSE, Nequi, Daviplata, Bancolombia. - **México (MX)**: CLABE Transfer #### Error Codes | Status | Code | Description | Solution | | --- | --- | --- | --- | | 400 | 305 | Invalid country_iso_code | Use valid ISO codes: AR, CL, CO, MX, BR | | 401 | 303 | Invalid signature | Check HMAC-SHA256 generation | | 401 | 301 | Missing authentication header | Include all required headers | | 404 | 404 | Country not supported | Verify country is in supported list | | 500 | 500 | Internal server error | Contact support if persists | operationId: payment-methods-by-country parameters: - name: country_iso_code in: path schema: type: string required: true responses: '200': description: Successful response. content: application/json: examples: SuccessArgentina: summary: Success - Argentina value: payment_methods: - method_id: 13 name: Pago con QR description: Pago con QR country: AR required_fields: [] - method_id: 15 name: Transferencia CVU description: CVU de uso único country: AR required_fields: [] SuccessColombia: summary: Success - Colombia value: payment_methods: - method_id: 5 name: PSE description: Transferencia Bancaria. country: CO required_fields: - name: bank_id type: select label: Banco required: true validation: type: string max_length: 10 options: - value: 1815 label: Alianza Fiduciaria - value: 1059 label: Bancamia S.A. - value: 1040 label: Banco Agrario - value: 1052 label: Banco Av Villas - value: 1013 label: Banco Bbva Colombia S.A. - value: 1032 label: Banco Caja Social - value: 1066 label: Banco Cooperativo Coopcentral - value: 1558 label: Banco Credifinanciera - value: 1051 label: Banco Davivienda - value: 1001 label: Banco De Bogota - value: 1023 label: Banco De Occidente - value: 1062 label: Banco Falabella - value: 1063 label: Banco Finandina S.A. Bic - value: 1012 label: Banco Gnb Sudameris - value: 1006 label: Banco Itau - value: 1071 label: Banco J.P. Morgan Colombia S.A. - value: 1047 label: Banco Mundo Mujer S.A. - value: 1060 label: Banco Pichincha S.A. - value: 1002 label: Banco Popular - value: 1065 label: Banco Santander Colombia - value: 1069 label: Banco Serfinanza - value: 1303 label: Banco Union Antes Giros - value: 1007 label: Bancolombia - value: 1061 label: Bancoomeva S.A. - value: 1808 label: Bold CF - value: 1283 label: Cfa Cooperativa Financiera - value: 1009 label: Citibank - value: 1812 label: Coink S.A. - value: 1370 label: Coltefinanciera - value: 1292 label: Confiar Cooperativa Financiera - value: 1289 label: Cotrafa - value: 1816 label: Crezcamos - value: 1097 label: Dale - value: 1551 label: Daviplata - value: 1802 label: Ding - value: 1121 label: Financiera Juriscoop S.A. - value: 1637 label: Iris - value: 1286 label: JFK Cooperativa Financiera - value: 1070 label: Lulo Bank - value: 1801 label: Movii S.A. - value: 1809 label: NU - value: 1507 label: Nequi - value: 1803 label: Powwi - value: 1811 label: RappiPay - value: 1019 label: Scotiabank Colpatria - value: 1804 label: UALÁ - name: document_number type: text label: Número de documento required: true validation: type: string max_length: 20 pattern: ^[0-9]+$ - name: document_type type: select label: Tipo de documento required: true validation: type: string enum: - CC - NIT options: - value: CC label: Cédula de Ciudadanía - value: NIT label: Número de Identificación Tributaria - name: first_name type: text label: Nombre required: true validation: type: string max_length: 100 - name: last_name type: text label: Apellido required: true validation: type: string max_length: 100 - name: phone type: text label: Teléfono required: true validation: type: string pattern: ^\+57[0-9]{10}$ placeholder: 573001234567 - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 6 name: Bancolombia description: Transferencia Bancaria. country: CO required_fields: - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 7 name: Nequi description: Transferencia Bancaria. country: CO required_fields: - name: phone type: text label: Teléfono required: true validation: type: string pattern: ^\+57[0-9]{10}$ placeholder: 573001234567 - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 8 name: Daviplata description: Transferencia Bancaria. country: CO required_fields: - name: document_type type: select label: Tipo de documento required: true validation: type: string enum: - CC - CE options: - value: CC label: Cédula de Ciudadanía - value: CE label: Cédula de Extranjería - name: document_number type: text label: Número de documento required: true validation: type: string max_length: 20 pattern: ^[0-9]+$ - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 16 name: Bre-B description: Transferencia Bancaria Bre-B. country: CO required_fields: [] SuccessChile: summary: Success - Chile value: payment_methods: - method_id: 3 name: Webpay description: Tarjeta de Crédito, Débito o Prepaga. country: CL required_fields: - name: first_name type: text label: Nombre required: true validation: type: string max_length: 100 - name: last_name type: text label: Apellido required: true validation: type: string max_length: 100 - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 14 name: Fintoc description: Tarjetas de Crédito y Débito. country: CL required_fields: [] SuccessBolivia: summary: Success - Bolivia value: payment_methods: - method_id: 3 name: Webpay description: Tarjeta de Crédito, Débito o Prepaga. country: CL required_fields: - name: first_name type: text label: Nombre required: true validation: type: string max_length: 100 - name: last_name type: text label: Apellido required: true validation: type: string max_length: 100 - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - method_id: 14 name: Fintoc description: Tarjetas de Crédito y Débito. country: CL required_fields: [] SuccessBrazil: summary: Success - Brazil value: payment_methods: - method_id: 12 name: Pago con PIX description: Pago con QR o Copia e Cola. country: BR required_fields: - name: document_number type: text label: Número de documento required: true validation: type: string max_length: 20 pattern: ^[0-9]+$ - name: email type: text label: Correo electrónico required: true validation: type: string max_length: 255 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ - name: first_name type: text label: Nombre required: true validation: type: string max_length: 100 - name: last_name type: text label: Apellido required: true validation: type: string max_length: 100 SuccessMXico: summary: Success - México value: payment_methods: - method_id: 11 name: Transferencia Bancaria Nacional description: Pago a Clabe de un solo uso. country: MX required_fields: - name: first_name type: text label: Nombre required: true validation: type: string max_length: 100 - name: last_name type: text label: Apellido required: true validation: type: string max_length: 100 ErrorNoMethodsAvailable: summary: Error - No methods available value: payment_methods: [] '401': description: Authentication error. content: application/json: example: error: Authentication failed components: securitySchemes: xLogin: type: apiKey in: header name: x-login description: Business xLogin xTransKey: type: apiKey in: header name: x-trans-key description: Business xTransKey xDate: type: apiKey in: header name: x-date description: ISO8601 datetime hmacSignature: type: apiKey in: header name: Authorization description: 'V2-HMAC-SHA256 signature. Example: `V2-HMAC-SHA256, Signature: `' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.