API Reference / Payment Attempts REST

Actions

Creates a payment attempt to pre-validate and initialize a payment flow.

POST/payment-attempts

Create Attempt

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.

Request body

externalIdstring

External reference identifier for integrations.

identityIdstringrequired

Identifier linking the transaction to a specific user or organization.

identityExternalIdstring

External reference identifier for the identity associated with the transaction.

accountNumberstringrequired

The account number involved in the transaction.

totalAmountstring

Final/destination amount mode. Send either totalAmount or purchaseAmount, never both.

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.

descriptionstring

A brief description of the transaction.

productstring

The product or service related to the transaction. purchaseCurrency:Currency

typestringrequired

PURCHASETOPUP_ACCOUNTWITHDRAWAL_ACCOUNTP2PCOLLECTFEEREMITTANCE

purchaseAmountstring

Source/customer-entered amount mode. Send either purchaseAmount or totalAmount, never both.

purchaseCurrencystring

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.

originsoneOf[]

A list of sources for the transaction.

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 for Argentina (ARS). Supports pay-in (static or dynamic CVU allocation) and pay-out (provide recipient CVU code). 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.

externalIdstring

External reference identifier for integrations.

amountstring

The amount involved in the transaction.

amountOutstring

Net amount after all fees have been deducted from this node. Equal to amount minus fee.amount.

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.

settlementstring

Indicates the settlement period.

feeobjectshow 5 properties

Details about any fees applied to the transaction.

identityobjectshow 4 properties

The entity associated with the source or destination.

metadataobjectshow 3 properties

Additional metadata related to the transaction source or destination.

One of

CARDACCOUNTBANK_ACCOUNTCRYPTOPIXPCTETPAYFINTOCWEBPAYWOMPIPSEBANCOLOMBIADAVIVIENDADAVIPLATANEQUIBREBCVUSPEILIGOSIPACHWIREFEDNOWRTPSEPAFPESWIFT

cardobjectrequired− hide properties

holderstring

Card holder full name

schemestring

Card scheme

typestring

Card type

maskstring

Last 4 digits

countrystring

Issuing country

tokenstringrequired

Card token

accountobjectrequired− hide properties

typestringrequired

CHECKINGFiat liquid account used for spending, withdrawals, or operations.

ASSETTracks non-operational or financial assets.

SAVINGSHolds funds intended for savings or long-term storage.

ESCROWTemporary routing account for incoming funds.

FEEHolds all fees collected via FEE or FEE_INVOICE.

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.

accountNumberstringrequired

Internal reference number for the account.

accountHolderstringrequired

Name of the entity or user owning the internal account.

bankobjectrequired− hide properties

accountNumberstringrequired

The bank account number.

bankstringrequired

The name of the bank where the account is held.

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.

typeAccountstring

Type of bank account. Accepted values: CHECKING, SAVINGS.

accountHolderstringrequired

The full name of the account holder.

accountHolderDnistringrequired

The national identification number or tax ID of the account holder.

countrystringrequired

Country of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.

walletobjectrequired− hide properties

providerstring

Optional wallet provider identifier (for routing/integration).

referenceIdstring

Optional external wallet identifier in the provider system.

tokenstring

Optional token symbol (e.g., USDC, USDT) when not implied by currency.

networkstring

Optional blockchain network (e.g., ETH, TRON, SOLANA).

addressstringrequired

Wallet's address

pixobjectrequired− hide properties

datastringrequired

The actual PIX code (EMV-compliant string) that represents the payment. This is what is known as the 'PIX' in Brazil and can be copied and pasted instead of scanning.

qrCodestring

The rendered QR code string that can be scanned for PIX payments.

expiredAtstringdate-time

The expiration date and time of the QR code. UTC format.

instructionsstring

Optional instructions displayed to the user for completing the PIX payment.

customerobjectrequiredshow 9 properties

Details of the customer initiating the payment.

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

pctobjectrequired− hide properties

qrCodestring

The QR code string that can be rendered or scanned for interoperable transfer payments in Argentina under the BCRA's PCT (Transfer QR) standard.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

etpayobjectrequired− hide properties

customerobjectshow 9 properties

Information on who pays the transaction

urlstring

redirectUrlstringdeprecated

expiresAtstringtime

tokenstring

signatureTokenstring

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

fintocobjectrequired− hide properties

customerobjectshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

webpayobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

wompiobjectshow 6 properties

Wompi gateway payload for Colombia pay-ins.

pseobjectrequired− hide properties

bankIdstringrequired

Bank identifier for PSE transfer.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

bancolombiaobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

daviviendaobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

daviplataobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

nequiobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

brebobjectrequired− hide properties

bankIdstringrequired

Bank identifier for the recipient's account.

accountNumberstringrequired

Recipient's bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

cvuobjectrequired− hide properties

codestring

The CVU code for this node. Required when CVU is used as a destination (pay-out) — provide the recipient's CVU number. For pay-in in dynamic mode, omit this field — the platform allocates a unique code per payment attempt and returns it here in the response. In static pay-in mode, this field carries the fixed CVU pre-assigned to the identity; retrieve it with GET /payment-origins and send it in the CVU origin when creating the static CVU payment.

customerobjectshow 9 properties

Information on who pays the transaction

speiobjectrequired− hide properties

clabestringrequired

CLABE (18-digit interbank code) of the recipient. Required for pay-out.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

ligoobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

sipobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

achobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

wireobjectrequired− hide properties

swiftCodestringrequired

SWIFT/BIC code of the recipient's bank.

routingNumberstring

ABA routing number (9 digits).

accountNumberstringrequired

Recipient's bank account number.

bankNamestring

Name of the recipient's bank.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

fedNowobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

rtpobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

sepaobjectrequired− hide properties

ibanstringrequired

Recipient's IBAN.

bicstring

BIC/SWIFT code of the recipient's bank.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

fpeobjectrequired− hide properties

accountNumberstringrequired

UK bank account number (8 digits).

sortCodestringrequired

Sort code (6 digits, e.g., "200415").

customerobjectrequiredshow 9 properties

Information on who pays the transaction

swiftobjectrequired− hide properties

swiftCodestringrequired

SWIFT/BIC code of the recipient's bank.

ibanstring

Recipient IBAN when destination country requires it (typically SEPA zone).

bankobjectrequiredshow 2 properties

Recipient bank account details.

customerobjectrequiredshow 9 properties

Beneficiary identity data required by correspondent banks.

destinationsoneOf[]

A list of destinations for the transaction.

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 for Argentina (ARS). Supports pay-in (static or dynamic CVU allocation) and pay-out (provide recipient CVU code). 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.

externalIdstring

External reference identifier for integrations.

amountstring

The amount involved in the transaction.

amountOutstring

Net amount after all fees have been deducted from this node. Equal to amount minus fee.amount.

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.

settlementstring

Indicates the settlement period.

feeobjectshow 5 properties

Details about any fees applied to the transaction.

identityobjectshow 4 properties

The entity associated with the source or destination.

metadataobjectshow 3 properties

Additional metadata related to the transaction source or destination.

One of

CARDACCOUNTBANK_ACCOUNTCRYPTOPIXPCTETPAYFINTOCWEBPAYWOMPIPSEBANCOLOMBIADAVIVIENDADAVIPLATANEQUIBREBCVUSPEILIGOSIPACHWIREFEDNOWRTPSEPAFPESWIFT

cardobjectrequired− hide properties

holderstring

Card holder full name

schemestring

Card scheme

typestring

Card type

maskstring

Last 4 digits

countrystring

Issuing country

tokenstringrequired

Card token

accountobjectrequired− hide properties

typestringrequired

CHECKINGFiat liquid account used for spending, withdrawals, or operations.

ASSETTracks non-operational or financial assets.

SAVINGSHolds funds intended for savings or long-term storage.

ESCROWTemporary routing account for incoming funds.

FEEHolds all fees collected via FEE or FEE_INVOICE.

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.

accountNumberstringrequired

Internal reference number for the account.

accountHolderstringrequired

Name of the entity or user owning the internal account.

bankobjectrequired− hide properties

accountNumberstringrequired

The bank account number.

bankstringrequired

The name of the bank where the account is held.

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.

typeAccountstring

Type of bank account. Accepted values: CHECKING, SAVINGS.

accountHolderstringrequired

The full name of the account holder.

accountHolderDnistringrequired

The national identification number or tax ID of the account holder.

countrystringrequired

Country of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.

walletobjectrequired− hide properties

providerstring

Optional wallet provider identifier (for routing/integration).

referenceIdstring

Optional external wallet identifier in the provider system.

tokenstring

Optional token symbol (e.g., USDC, USDT) when not implied by currency.

networkstring

Optional blockchain network (e.g., ETH, TRON, SOLANA).

addressstringrequired

Wallet's address

pixobjectrequired− hide properties

datastringrequired

The actual PIX code (EMV-compliant string) that represents the payment. This is what is known as the 'PIX' in Brazil and can be copied and pasted instead of scanning.

qrCodestring

The rendered QR code string that can be scanned for PIX payments.

expiredAtstringdate-time

The expiration date and time of the QR code. UTC format.

instructionsstring

Optional instructions displayed to the user for completing the PIX payment.

customerobjectrequiredshow 9 properties

Details of the customer initiating the payment.

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

pctobjectrequired− hide properties

qrCodestring

The QR code string that can be rendered or scanned for interoperable transfer payments in Argentina under the BCRA's PCT (Transfer QR) standard.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

etpayobjectrequired− hide properties

customerobjectshow 9 properties

Information on who pays the transaction

urlstring

redirectUrlstringdeprecated

expiresAtstringtime

tokenstring

signatureTokenstring

successUrlstring

Redirect url in case of success

failedUrlstring

Redirect url in case of failure

fintocobjectrequired− hide properties

customerobjectshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

webpayobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

wompiobjectshow 6 properties

Wompi gateway payload for Colombia pay-ins.

pseobjectrequired− hide properties

bankIdstringrequired

Bank identifier for PSE transfer.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

bancolombiaobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

daviviendaobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

daviplataobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

nequiobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

brebobjectrequired− hide properties

bankIdstringrequired

Bank identifier for the recipient's account.

accountNumberstringrequired

Recipient's bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

cvuobjectrequired− hide properties

codestring

The CVU code for this node. Required when CVU is used as a destination (pay-out) — provide the recipient's CVU number. For pay-in in dynamic mode, omit this field — the platform allocates a unique code per payment attempt and returns it here in the response. In static pay-in mode, this field carries the fixed CVU pre-assigned to the identity; retrieve it with GET /payment-origins and send it in the CVU origin when creating the static CVU payment.

customerobjectshow 9 properties

Information on who pays the transaction

speiobjectrequired− hide properties

clabestringrequired

CLABE (18-digit interbank code) of the recipient. Required for pay-out.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

ligoobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

sipobjectrequired− hide properties

customerobjectrequiredshow 9 properties

Information on who pays the transaction

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.

achobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

wireobjectrequired− hide properties

swiftCodestringrequired

SWIFT/BIC code of the recipient's bank.

routingNumberstring

ABA routing number (9 digits).

accountNumberstringrequired

Recipient's bank account number.

bankNamestring

Name of the recipient's bank.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

fedNowobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

rtpobjectrequired− hide properties

routingNumberstringrequired

ABA routing number (9 digits).

accountNumberstringrequired

Bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequiredshow 9 properties

Information on who pays the transaction

sepaobjectrequired− hide properties

ibanstringrequired

Recipient's IBAN.

bicstring

BIC/SWIFT code of the recipient's bank.

customerobjectrequiredshow 9 properties

Information on who pays the transaction

fpeobjectrequired− hide properties

accountNumberstringrequired

UK bank account number (8 digits).

sortCodestringrequired

Sort code (6 digits, e.g., "200415").

customerobjectrequiredshow 9 properties

Information on who pays the transaction

swiftobjectrequired− hide properties

swiftCodestringrequired

SWIFT/BIC code of the recipient's bank.

ibanstring

Recipient IBAN when destination country requires it (typically SEPA zone).

bankobjectrequiredshow 2 properties

Recipient bank account details.

customerobjectrequiredshow 9 properties

Beneficiary identity data required by correspondent banks.

Responses

201Resource created successfully.

idstringrequired

Unique identifier for the internal service.

externalIdstringrequired

External reference identifier for integrations.

identityIdstringrequired

Identifier linking the transaction to a specific user or organization.

identityExternalIdstring

External reference identifier for the identity associated with the transaction.

accountNumberstringrequired

The account number involved in the transaction.

totalAmountstringrequired

The total amount of the transaction.

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.

descriptionstring

A brief description of the transaction.

productstring

The product or service related to the transaction. purchaseCurrency:Currency

statusstringrequired

Lifecycle state of the payment. Possible values: CREATED, AUTHORIZED, REQUIRES_REVIEW, CAPTURED, RECEIVED, SETTLED (terminal — success), FAILED, EXPIRED, UNSETTLED (terminal — error).

typestringrequired

PURCHASEPayment initiated by an external customer for goods or services.

TOPUP_ACCOUNTA deposit of funds into an internal account

WITHDRAWAL_ACCOUNTFunds withdrawn from an internal account to an external bank account.

P2PPull of funds from another internal account.

COLLECTPull of funds from another internal account.

FEEFee charged or collected within the system.

REMITTANCECrossborder payment from an internal or external account to receipient in another country.

purchaseAmountstring

The amount paid in the transaction.

purchaseCurrencystring

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.

feesobject[]show items

A list of fees associated with the transaction.

createdAtstringrequired

Timestamp indicating when the transaction was created.

updatedAtstringrequired

Timestamp indicating the last update to the transaction.

expiresAtstring

Timestamp indicating when the transaction expires, if applicable.

capturedAtstring

Timestamp indicating when the transaction was captured.

authorizedAtstring

Timestamp indicating when the transaction was authorized.

refundedAtstring

Timestamp indicating when the transaction was refunded, if applicable.

originsoneOf[]show items

A list of sources for the transaction.

destinationsoneOf[]show items

A list of destinations for the transaction.

settlementstring

Settlement period for the transaction.

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.

CodeTry it Workbench

Request

HTTPcurlTypeScriptPythonGoRust

POST /sandbox/payment-attempts 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
Content-Type: application/json

{
  "identityId": "679c482ee4420cb5b0966c9a",
  "accountNumber": "123456",
  "product": "ARS:ARS",
  "type": "PAYMENT",
  "purchaseAmount": "100",
  "purchaseCurrency": "ARS",
  "currency": "ARS",
  "origins": [
    {
      "name": "ETPAY",
      "type": "PAYMENT_INITATION",
      "amount": "100",
      "currency": "ARS",
      "paymentInitiation": {
        "origin": "ETPAY",
        "referenceId": "external_payment_id_1"
      }
    }
  ],
  "destinations": [
    {
      "type": "ACCOUNT",
      "amount": "100",
      "currency": "ARS",
      "identity": {
        "userId": "679c482ee4420cb5b0966c9a",
        "name": "Jane Smith",
        "lastname": "Turner",
        "nickname": "Juanpe",
        "dni": "12312252"
      },
      "account": {
        "accountNumber": "123456"
      }
    }
  ]
}

curl -X POST \
  'https://api.conomyhq.com/sandbox/payment-attempts' \
  -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' \
  -H 'Content-Type: application/json' \
  -d '{
    "identityId": "679c482ee4420cb5b0966c9a",
    "accountNumber": "123456",
    "product": "ARS:ARS",
    "type": "PAYMENT",
    "purchaseAmount": "100",
    "purchaseCurrency": "ARS",
    "currency": "ARS",
    "origins": [
      {
        "name": "ETPAY",
        "type": "PAYMENT_INITATION",
        "amount": "100",
        "currency": "ARS",
        "paymentInitiation": {
          "origin": "ETPAY",
          "referenceId": "external_payment_id_1"
        }
      }
    ],
    "destinations": [
      {
        "type": "ACCOUNT",
        "amount": "100",
        "currency": "ARS",
        "identity": {
          "userId": "679c482ee4420cb5b0966c9a",
          "name": "Jane Smith",
          "lastname": "Turner",
          "nickname": "Juanpe",
          "dni": "12312252"
        },
        "account": {
          "accountNumber": "123456"
        }
      }
    ]
  }'

const response = await fetch('https://api.conomyhq.com/sandbox/payment-attempts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'x-api-key': '{YOUR_API_KEY}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "identityId": "679c482ee4420cb5b0966c9a",
    "accountNumber": "123456",
    "product": "ARS:ARS",
    "type": "PAYMENT",
    "purchaseAmount": "100",
    "purchaseCurrency": "ARS",
    "currency": "ARS",
    "origins": [
      {
        "name": "ETPAY",
        "type": "PAYMENT_INITATION",
        "amount": "100",
        "currency": "ARS",
        "paymentInitiation": {
          "origin": "ETPAY",
          "referenceId": "external_payment_id_1"
        }
      }
    ],
    "destinations": [
      {
        "type": "ACCOUNT",
        "amount": "100",
        "currency": "ARS",
        "identity": {
          "userId": "679c482ee4420cb5b0966c9a",
          "name": "Jane Smith",
          "lastname": "Turner",
          "nickname": "Juanpe",
          "dni": "12312252"
        },
        "account": {
          "accountNumber": "123456"
        }
      }
    ]
  }),
});

const data = await response.json();

import requests

payload = {
    "identityId": "679c482ee4420cb5b0966c9a",
    "accountNumber": "123456",
    "product": "ARS:ARS",
    "type": "PAYMENT",
    "purchaseAmount": "100",
    "purchaseCurrency": "ARS",
    "currency": "ARS",
    "origins": [
        {
            "name": "ETPAY",
            "type": "PAYMENT_INITATION",
            "amount": "100",
            "currency": "ARS",
            "paymentInitiation": {
                "origin": "ETPAY",
                "referenceId": "external_payment_id_1"
            }
        }
    ],
    "destinations": [
        {
            "type": "ACCOUNT",
            "amount": "100",
            "currency": "ARS",
            "identity": {
                "userId": "679c482ee4420cb5b0966c9a",
                "name": "Jane Smith",
                "lastname": "Turner",
                "nickname": "Juanpe",
                "dni": "12312252"
            },
            "account": {
                "accountNumber": "123456"
            }
        }
    ]
}

response = requests.post(
    'https://api.conomyhq.com/sandbox/payment-attempts',
    headers={
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'x-api-key': '{YOUR_API_KEY}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
    },
    json=payload
)

data = response.json()

package main

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

func main() {
	payload, _ := json.Marshal(	{
	  "identityId": "679c482ee4420cb5b0966c9a",
	  "accountNumber": "123456",
	  "product": "ARS:ARS",
	  "type": "PAYMENT",
	  "purchaseAmount": "100",
	  "purchaseCurrency": "ARS",
	  "currency": "ARS",
	  "origins": [
	    {
	      "name": "ETPAY",
	      "type": "PAYMENT_INITATION",
	      "amount": "100",
	      "currency": "ARS",
	      "paymentInitiation": {
	        "origin": "ETPAY",
	        "referenceId": "external_payment_id_1"
	      }
	    }
	  ],
	  "destinations": [
	    {
	      "type": "ACCOUNT",
	      "amount": "100",
	      "currency": "ARS",
	      "identity": {
	        "userId": "679c482ee4420cb5b0966c9a",
	        "name": "Jane Smith",
	        "lastname": "Turner",
	        "nickname": "Juanpe",
	        "dni": "12312252"
	      },
	      "account": {
	        "accountNumber": "123456"
	      }
	    }
	  ]
	})
	body := bytes.NewBuffer(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/payment-attempts", body)
	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")
	req.Header.Set("Content-Type", "application/json")

	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
        .post("https://api.conomyhq.com/sandbox/payment-attempts")
        .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")
        .header("Content-Type", "application/json")
        .json(&json!({
        "identityId": "679c482ee4420cb5b0966c9a",
        "accountNumber": "123456",
        "product": "ARS:ARS",
        "type": "PAYMENT",
        "purchaseAmount": "100",
        "purchaseCurrency": "ARS",
        "currency": "ARS",
        "origins": [
                {
                        "name": "ETPAY",
                        "type": "PAYMENT_INITATION",
                        "amount": "100",
                        "currency": "ARS",
                        "paymentInitiation": {
                                "origin": "ETPAY",
                                "referenceId": "external_payment_id_1"
                        }
                }
        ],
        "destinations": [
                {
                        "type": "ACCOUNT",
                        "amount": "100",
                        "currency": "ARS",
                        "identity": {
                                "userId": "679c482ee4420cb5b0966c9a",
                                "name": "Jane Smith",
                                "lastname": "Turner",
                                "nickname": "Juanpe",
                                "dni": "12312252"
                        },
                        "account": {
                                "accountNumber": "123456"
                        }
                }
        ]
}))
        .send()
        .await?;

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

Response

201 400 401 403 404 422 500

{
  "id": "string",
  "externalId": "string",
  "identityId": "string",
  "identityExternalId": "string",
  "accountNumber": "string",
  "totalAmount": "string",
  "currency": "string",
  "description": "string",
  "product": "string",
  "status": "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
}

Requestsandbox

Authentication

Bearer token*

Headers

x-api-key*

User-Agent*

Body

jsonFormat

{ "identityId": "679c482ee4420cb5b0966c9a", "accountNumber": "123456", "product": "ARS:ARS", "type": "PAYMENT", "purchaseAmount": "100", "purchaseCurrency": "ARS", "currency": "ARS", "origins": [ { "name": "ETPAY", "type": "PAYMENT_INITATION", "amount": "100", "currency": "ARS", "paymentInitiation": { "origin": "ETPAY", "referenceId": "external_payment_id_1" } } ], "destinations": [ { "type": "ACCOUNT", "amount": "100", "currency": "ARS", "identity": { "userId": "679c482ee4420cb5b0966c9a", "name": "Jane Smith", "lastname": "Turner", "nickname": "Juanpe", "dni": "12312252" }, "account": { "accountNumber": "123456" } } ] }

Send →