feat(connector): add support for santander pix payouts

[aniketburman014]

Description

Integrates Santander Brazil as a payout connector supporting Pix payments (key-based, QR/EMV, and bank account transfers) via the management payments partners API with mTLS.

Motivation and Context

Additional Changes

• This PR modifies the API contract
• This PR modifies application configuration/environment variables

How did you test it?

Via Hyperswitch

Request

{
  "amount": 1500,
  "currency": "BRL",
  "connector": ["santander"],
  "customer_id": "cus_bw5T9ISg3KE6XP0pripr",
  "payout_type": "bank",
     "payout_method_data": {
      "bank_transfer": {
        "payout_method_type": "pix",
        "bank_branch": "0001",
        "bank_account_number": "20294925",
        "bank_type": "checking",
        "tax_id": "44494387100",
        "account_holder_name" : "MARGARETCH PIRAI CONDOR",
        
        "bank_code": "033"
      }
    },
  "billing": {
    "address": {
      "country": "BR"
    }
  },
  "description": "Santander PIX payout",
  "profile_id": "pro_lcr5iL63I2S4p2GmRmPQ",
  "confirm": true,
  "auto_fulfill": true
}

Response

{
    "payout_id": "payout_l3jk97Inlm9c2lIU9NRF",
    "merchant_id": "merchant_1781624290",
    "merchant_order_reference_id": null,
    "amount": 1500,
    "currency": "BRL",
    "connector": "santander",
    "payout_type": "bank",
    "payout_method_data": {
        "bank": {
            "pix_key": null,
            "emv": null,
            "tax_id": "*******7100",
            "bank_account_number": "****4925",
            "bank_name": null,
            "bank_branch": "0001",
            "ispb": null,
            "bank_code": "033",
            "bank_type": "checking"
        }
    },
    "source_bank_data": null,
    "billing": {
        "address": {
            "city": null,
            "country": "BR",
            "line1": null,
            "line2": null,
            "line3": null,
            "zip": null,
            "state": null,
            "first_name": null,
            "last_name": null,
            "origin_zip": null
        },
        "phone": null,
        "email": null
    },
    "auto_fulfill": true,
    "customer_id": "cus_bw5T9ISg3KE6XP0pripr",
    "customer": {
        "id": "cus_bw5T9ISg3KE6XP0pripr",
        "name": "John Doe",
        "email": "guest@example.com",
        "phone": "9876543210",
        "phone_country_code": "+65",
        "customer_document_details": null
    },
    "client_secret": "payout_payout_l3jk97Inlm9c2lIU9NRF_secret_njDqZZQIVBJqaqj72DK5",
    "return_url": null,
    "business_country": null,
    "business_label": null,
    "description": "Santander PIX payout",
    "entity_type": "Individual",
    "recurring": false,
    "metadata": {},
    "merchant_connector_id": "mca_dcF6wBYIQ6bT7HzY7ajm",
    "status": "success",
    "error_message": null,
    "error_code": null,
    "profile_id": "pro_lcr5iL63I2S4p2GmRmPQ",
    "created": "2026-08-04T21:05:22.649Z",
    "connector_transaction_id": "27b0b712-33b8-4ab3-b2f9-6c814f881394",
    "priority": null,
    "payout_link": null,
    "email": "guest@example.com",
    "name": "John Doe",
    "phone": "9876543210",
    "phone_country_code": "+65",
    "unified_code": null,
    "unified_message": null,
    "payout_method_id": null
}

Request

{
  "amount": 1500,
  "currency": "BRL",
  "connector": ["santander"],
  "customer_id": "cus_bw5T9ISg3KE6XP0pripr",
  "payout_type": "bank",

  "payout_method_data": {
    "bank_transfer": {
      "payout_method_type": "pix_key",
      "pix_key": "teste_api_projeto_cobranca@santander.com.br"
    }
  },
  "billing": {
    "address": {
      "country": "BR"
    }
  },
  "description": "Santander PIX payout",
  "profile_id": "pro_lcr5iL63I2S4p2GmRmPQ",
  "confirm": true,
  "auto_fulfill": true
}

Response

{
    "payout_id": "payout_ZqmgXD1PtTS0rmYw6fSh",
    "merchant_id": "merchant_1781624290",
    "merchant_order_reference_id": null,
    "amount": 1500,
    "currency": "BRL",
    "connector": "santander",
    "payout_type": "bank",
    "payout_method_data": {
        "bank": {
            "pix_key": "test*_***_*******_********@*********.**m.br",
            "emv": null,
            "tax_id": null,
            "bank_account_number": null,
            "bank_name": null,
            "bank_branch": null,
            "ispb": null,
            "bank_code": null,
            "bank_type": null
        }
    },
    "source_bank_data": null,
    "billing": {
        "address": {
            "city": null,
            "country": "BR",
            "line1": null,
            "line2": null,
            "line3": null,
            "zip": null,
            "state": null,
            "first_name": null,
            "last_name": null,
            "origin_zip": null
        },
        "phone": null,
        "email": null
    },
    "auto_fulfill": true,
    "customer_id": "cus_bw5T9ISg3KE6XP0pripr",
    "customer": {
        "id": "cus_bw5T9ISg3KE6XP0pripr",
        "name": "John Doe",
        "email": "guest@example.com",
        "phone": "9876543210",
        "phone_country_code": "+65",
        "customer_document_details": null
    },
    "client_secret": "payout_payout_ZqmgXD1PtTS0rmYw6fSh_secret_q40PqoWctQc3grOp5Ung",
    "return_url": null,
    "business_country": null,
    "business_label": null,
    "description": "Santander PIX payout",
    "entity_type": "Individual",
    "recurring": false,
    "metadata": {},
    "merchant_connector_id": "mca_dcF6wBYIQ6bT7HzY7ajm",
    "status": "success",
    "error_message": null,
    "error_code": null,
    "profile_id": "pro_lcr5iL63I2S4p2GmRmPQ",
    "created": "2026-08-04T21:12:38.079Z",
    "connector_transaction_id": "642d9aaf-58e0-4fd0-a507-2259da7c80b3",
    "priority": null,
    "payout_link": null,
    "email": "guest@example.com",
    "name": "John Doe",
    "phone": "9876543210",
    "phone_country_code": "+65",
    "unified_code": null,
    "unified_message": null,
    "payout_method_id": null
}