# /catalogs/countries/{idCountry}/deliver-methods/{idDelivery}/payouts

## Purpose
Returns the available payout methods for a destination country and delivery method.

## When to use
Use this endpoint to:
- Populate payout provider lists (banks, networks, wallet providers)
- Retrieve corridor constraints (min/max, fee, exchange rate)
- Validate account formats using the provided accNumberRegex (when present)

## Authentication
Requires x-client-id and x-secret-key headers.

## Notes
- idCountry is an ISO3 country code.
- idDelivery represents the delivery method (e.g., bank deposit vs cash pickup; see your configured codes).
- The response may include validation helpers like accNumberRegex.

## Common errors
- 400 Validation errors
- 401 Invalid credentials
- 404 Configuration not found (when applicable)
- 500 Internal error

Endpoint: GET /catalogs/countries/{idCountry}/deliver-methods/{idDelivery}/payouts
Version: 1.0.0

## Header parameters:

  - `x-client-id` (string, required)
    Error codes: required=400001, type=400002, minLength=400003, maxLength=400004
    Example: "xxxx123456789"

  - `x-secret-key` (string, required)
    Error codes: required=400001, type=400002, minLength=400003, maxLength=400004
    Example: "xxxx987654321"

## Path parameters:

  - `idCountry` (string, required)
    Country ISO3 code (e.g., USA, MEX, COL)
    Example: "USA"

  - `idDelivery` (string, required)
    Delivery method ID (e.g., C for bank deposit, P for cash pickup)
    Example: "C"

## Response 200 fields (application/json):

  - `idpayout` (string)

  - `namePayout` (string)

  - `idCountry` (string)

  - `nameCountry` (string)

  - `idPayer` (string)

  - `exchangeRate` (number)

  - `fee` (number)

  - `minAmount` (number)

  - `maxAmount` (number)

  - `urlImage` (string)

  - `iso3Currency` (string)

  - `accNumberRegex` (string)

## Response 400 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 400 (click to expand)CodeDescription400000The body of the request is required. Invalid JSON format of the request body.400001client_id is required400005secret_key is required

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 401 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 401 (click to expand)CodeDescription401000Invalid credentials

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 404 (click to expand)CodeDescription401000Location not found

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    List of object errorsError catalog for 500 (click to expand)CodeDescription500000Internal Error

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

  - `errors.details` (string)