API Reference / Origins & Destinations REST

Actions

Returns available payout node configurations for the requested product and currency pair.

GET/payment-destinations

Get payment-destinations

Headers

Authorizationstringrequired

Bearer access token returned by the authentication endpoint.

x-api-keystringrequired

The API key used for authentication when making requests to the API Gateway.

conomyhq-api-versionstring

API version selector for Conomy endpoints. Use 24-04-2025 for the current version.

User-Agentstringrequired

Identifies the application making the request.

Query parameters

accountNumberstring

corresponding accountNumber

typestring

type of destination

Responses

200Request processed successfully.

namestring

The name of the source or destination of the transaction.

typestringrequired

CARDRepresents a card payment. Opens the card node.

CRYPTOCryptocurrency wallet rail (global). Supports both pay-in and pay-out flows. Opens the wallet node.

ACCOUNTRepresents an internal platform account. Opens the account node.

BANK_ACCOUNTGeneric external bank account for payouts. Opens the bank node.

PIXPIX QR code or copy-paste code in Brazil (BRL). Opens the pix node.

PCTInteroperable QR payment in Argentina (ARS) under BCRA PCT standard. Opens the pct node.

CVUVirtual account / CBU bank transfer pay-in in Argentina (ARS). Opens the cvu node.

ETPAYOpen banking pay-in for Chile (CLP) via Etpay. Opens the etpay node.

FINTOCOpen banking pay-in for Chile (CLP) via Fintoc widget. Opens the fintoc node.

WEBPAYCard payment in Chile (CLP) via Transbank. Opens the webpay node.

SPEIElectronic Interbank Payment System for Mexico (MXN). Opens the spei node.

PSEOnline secure bank transfer pay-in for Colombia (COP). Opens the pse node.

BANCOLOMBIABancolombia direct payment pay-in for Colombia (COP). Opens the bancolombia node.

DAVIVIENDADavivienda direct payment pay-in for Colombia (COP). Opens the davivienda node.

DAVIPLATADaviplata mobile wallet for Colombia (COP). Opens the daviplata node.

NEQUINequi digital wallet for Colombia (COP). Opens the nequi node.

BREBBank account transfer payout for Colombia (COP). Opens the breb node.

WOMPIWompi payment gateway pay-in for Colombia (COP). Opens the wompi node.

LIGOQR-based payment system pay-in for Peru (PEN). Opens the ligo node.

SIPInteroperable payment system for Peru (PEN) and Bolivia (BOB). Opens the sip node.

ACHAutomated Clearing House bank transfers for USA (USD). Opens the ach node.

WIREWire transfer via correspondent banks for USA (USD). Opens the wire node.

FEDNOWFedNow instant payment service for USA (USD). Opens the fedNow node.

RTPReal-time payments network pay-in for USA (USD). Opens the rtp node.

SEPASingle Euro Payments Area payout for Europe (EUR). Opens the sepa node.

FPEFaster Payments near-instant bank transfer payout for UK (GBP). Opens the fpe node.

SWIFTInternational bank wire transfer rail (global). Pay-out only. Opens the swift node.

currencystringrequired

Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.

productstring

Product identifier for the payment rail, in the format CURRENCY:CURRENCY (e.g., ARS:ARS, USD:COP).

settlementstring

Indicates the settlement period.

feeobjectshow 5 properties

Details about any fees applied to the transaction.

metadataobjectshow 3 properties

Additional metadata related to the transaction source or destination.

minAmountstring/^\d+$/

Minimum transaction amount allowed for this node.

maxAmountstring/^\d+$/

Maximum transaction amount allowed for this node.

requiredFieldsstring[]

Dot-notation paths of fields required when using this node (e.g., bank.accountNumber, pct.customer.email).

validOriginsstring[]

Node types that are valid as origins when this node is used as a destination.

validDestinationsstring[]

Node types that are valid as destinations when this node is used as an origin.

nodeSchemaobject

Dynamic schema describing the structure of the node-specific object. Each key matches the node key (e.g., bank, pct, cvu) and its value reflects the expected field structure.

requiredFieldTypesobject

Map of dot-notation field paths to their expected types (e.g., { "bank.accountNumber": "string" }).

One of

CARDACCOUNTBANK_ACCOUNTCRYPTOPIXPCTETPAYFINTOCWEBPAYWOMPIPSEBANCOLOMBIADAVIVIENDADAVIPLATANEQUIBREBCVUSPEILIGOSIPACHWIREFEDNOWRTPSEPAFPESWIFT

cardobjectrequiredshow 6 properties

accountobjectrequiredshow 8 properties

bankobjectrequiredshow 7 properties

walletobjectrequiredshow 5 properties

pixobjectrequiredshow 2 properties

pctobjectrequiredshow 4 properties

etpayobjectrequiredshow 4 properties

fintocobjectrequiredshow 3 properties

webpayobjectrequiredshow 3 properties

wompiobjectshow 6 properties

Wompi gateway payload for Colombia pay-ins.

pseobjectrequiredshow 4 properties

bancolombiaobjectrequiredshow 3 properties

daviviendaobjectrequiredshow 3 properties

daviplataobjectrequiredshow 3 properties

nequiobjectrequiredshow 3 properties

brebobjectrequiredshow 4 properties

cvuobjectrequiredshow 2 properties

speiobjectrequiredshow 2 properties

ligoobjectrequiredshow 3 properties

sipobjectrequiredshow 3 properties

achobjectrequiredshow 4 properties

wireobjectrequiredshow 5 properties

fedNowobjectrequiredshow 4 properties

rtpobjectrequiredshow 4 properties

sepaobjectrequiredshow 3 properties

fpeobjectrequiredshow 3 properties

swiftobjectrequiredshow 4 properties

400Invalid request parameters or payload.

errorobjectshow 2 properties

messagestringnullable

Human-readable message. May be null.

500Unexpected internal server error.

errorobjectshow 2 properties

messagestringnullable

Human-readable message. May be null.

Request

HTTPcurlTypeScriptPythonGoRust

GET /sandbox/payment-destinations HTTP/1.1
Host: api.conomyhq.com
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {YOUR_API_KEY}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0

curl -X GET \
  'https://api.conomyhq.com/sandbox/payment-destinations' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'User-Agent: MyApp/1.0'

const response = await fetch('https://api.conomyhq.com/sandbox/payment-destinations', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'x-api-key': '{YOUR_API_KEY}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
  },
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.conomyhq.com/sandbox/payment-destinations',
    headers={
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'x-api-key': '{YOUR_API_KEY}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    }
)

data = response.json()

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.conomyhq.com/sandbox/payment-destinations", nil)
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")

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

	var data map[string]any
	json.NewDecoder(resp.Body).Decode(&data)
}

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let resp = client
        .get("https://api.conomyhq.com/sandbox/payment-destinations")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .send()
        .await?;

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

Response

200 400 401 403 404 422 500

[
  {
    "card": {
      "token": "string"
    }
  }
]

{
  "error": {
    "type": "bad_request",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "unauthorized",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "forbidden",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "not_found",
    "info": null
  },
  "message": null
}

{
  "error": {
    "type": "validation_error",
    "info": {
      "field": "string",
      "message": "string"
    }
  },
  "message": null
}

{
  "error": {
    "type": "internal_error",
    "info": null
  },
  "message": null
}