Render payment methods

This recipe shows how to decide what your UI should render before you create a payment. Do not hardcode ETPAY, PIX, BANK_ACCOUNT, or any other rail in your product. Ask Conomy what is available for the identity, then render only those options.

Note

Use this recipe before every new payment form. It prevents users from selecting a currency, rail, or node field that is not enabled for their identity.

Flow

Identify context

Know the identity, source currency, settlement currency, and business intent.

Discover products

Call available products and read enabled rails.

Render fields

Show only required fields for the selected node.

Create payment

Send the selected product, origin, and destination.

1. Discover enabled rails

Request

GET /sandbox/payments/available-products?identityId=<IDENTITY_ID>&currencies=CLP HTTP/1.1
Host: api.conomyhq.com
x-api-key: {YOUR_API_KEY}
Authorization: Bearer {ACCESS_TOKEN}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0
Accept: application/json

const response = await fetch('https://api.conomyhq.com/sandbox/payments/available-products?identityId=<IDENTITY_ID>&currencies=CLP', {
  method: 'GET',
  headers: {
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Accept': 'application/json',
  },
});

const data = await response.json();

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/payments/available-products?identityId=<IDENTITY_ID>&currencies=CLP", nil)
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")
	req.Header.Set("Accept", "application/json")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
}

use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let response = client
        .get("https://api.conomyhq.com/sandbox/payments/available-products?identityId=<IDENTITY_ID>&currencies=CLP")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .header("Accept", "application/json")
        .send()
        .await?;

    let data: serde_json::Value = response.json().await?;
    Ok(())
}

Response

{
  "supportedPaymentCurrencies": [
    "CLP"
  ],
  "supportedPayoutCurrencies": [
    "CLP"
  ],
  "supportedPaymentMethods": [
    "ETPAY",
    "FINTOC",
    "WEBPAY"
  ],
  "supportedWithdrawalMethods": [
    "BANK_ACCOUNT"
  ],
  "byCurrency": [
    {
      "currency": "CLP",
      "payin": {
        "paymentMethods": [
          "ETPAY",
          "FINTOC",
          "WEBPAY"
        ],
        "products": [
          {
            "name": "ETPAY",
            "type": "ETPAY",
            "currency": "CLP",
            "product": "CLP:CLP",
            "requiredFields": [
              "etpay.successUrl",
              "etpay.failedUrl",
              "etpay.customer.email"
            ],
            "validDestinations": [
              "ACCOUNT"
            ]
          }
        ]
      },
      "payout": {
        "withdrawalMethods": [
          "BANK_ACCOUNT"
        ],
        "products": [
          {
            "name": "BANK_ACCOUNT",
            "type": "BANK_ACCOUNT",
            "currency": "CLP",
            "product": "CLP:CLP",
            "requiredFields": [
              "bank.accountNumber",
              "bank.accountHolder",
              "customer.documentNumber"
            ],
            "validOrigins": [
              "ACCOUNT"
            ]
          }
        ]
      }
    }
  ]
}

2. Map the response to UI

For a top-up, render byCurrency[].payin.paymentMethods as the origin selector and force the destination to ACCOUNT when the selected product says validDestinations: ["ACCOUNT"].

For a withdrawal, force the origin to ACCOUNT and render byCurrency[].payout.withdrawalMethods as the destination selector.

3. Validate the node before submit

Use requiredFields as the source of truth. If the selected origin is ETPAY, the form must collect successUrl, failedUrl, and customer data before calling POST /payments.

Tip

The next step is Transaction builder, which turns the selected intent, rail, and account data into a complete POST /payments body.