Create payment attempt

Initiates a payment attempt by creating a transaction, storing initial details like amount and currency for a multi-step payment process.

Initiate a payment from a payment-attempt or create from scratch. This endpoint allows you to specify initial payment parameters such as amount, currency, and client references. It serves as the first step in a potential multi-step payment process, enabling you to store preliminary transaction details before finalizing. Useful for scenarios where payment information is gathered incrementally or requires user interaction at various stages.

post

Authorizations

x-api-keyBearer

Body

idstringoptional

Unique identifier assigned to each payment transaction within the system. It is used to reference and track transactions across all API operations, such as creating, confirming, and querying payments.

externalIdstringoptional

An external reference ID for the transaction, used for integrations with external systems.

externalIdentityIdstringoptional

External user reference ID, linking the transaction to the external system's user.

identityIdstringoptional

Internal identity identifier within the ConomyHQ system. It uniquely identifies the user associated with the transaction.

originsobject[]optional

payment schema

originAmountobjectoptional

The amount and currency of the transaction before applying any fees or exchanges.

destinationsobject[]optional

payment schema

destinationAmountobjectoptional

The amount and currency after applying fees and exchanges. This represents the total amount paid or withdrawn.

typestring · enumoptional

Represents the various types of financial transactions, ranging from card payments to remittances, savings-related transactions, and more.

Available options:

productstringoptional

The currency pair being traded, formatted as CURRENCY 1:CURRENCY 2, where the first currency is the base currency and the second is the counter currency. This defines what is being exchanged (e.g., CLP:USD or CLP:USDC_SOLANA).

statusstring · enumoptional

Available options:

enrichobjectoptional

The enrich object provides details about the merchant receiving the payment, including their code, name, and location.

settlementstring · enumoptional

Specifies how often settlements occur for this transaction, such as 'INSTANT', 'DAILY', 'WEEKLY', or 'MONTHLY'.

Available options:

feesobject[]optional

An array of fees applied to the transaction. Each fee entry describes the type and amount of the fee.

exchangeobjectoptional

An array of exchanges applied to the transaction, including currency conversions or asset exchanges.

metaDataobjectoptional

createdAtstringoptional

Creation date, in ISO 8601 date format

updatedAtstringoptional

Date of last update, in ISO 8601 date format

expiredAtstringoptional

The expiration date of the transaction, in ISO 8601 date format.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/payment-attempts' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "externalId": "text",
    "externalIdentityId": "text",
    "identityId": "text",
    "origins": [
      {
        "name": "text",
        "type": "text",
        "currency": "ARS",
        "referenceId": "text",
        "processing": "INSTANT_PAYMENT",
        "fee": {
          "name": "text",
          "type": "TRANSACTION",
          "method": "PERCENTAGE",
          "currency": "ARS",
          "value": "text"
        },
        "limits": {
          "minAmount": "text",
          "maxAmount": "text"
        },
        "metaData": {
          "image": "text",
          "title": "text",
          "description": "text"
        },
        "paymentInitiation": {
          "publicKey": "text",
          "widgetLink": "text",
          "signatureToken": "text",
          "origin": {
            "id": "text",
            "identity": "text",
            "externalId": "text",
            "accountNumber": "text",
            "nickName": "text",
            "country": "ARG",
            "currency": "ARS",
            "financialInstitution": "text",
            "type": "CASH_ACCOUNT",
            "accountHolder": "text",
            "accountHolderDni": "text",
            "balances": {
              "balance": "text",
              "availableFunds": "text",
              "accruedYield": "text",
              "monthlyYield": "text"
            },
            "createdAt": "text",
            "updatedAt": "text",
            "iban": "text",
            "sortCode": "text"
          }
        },
        "account": {
          "id": "text",
          "identity": "text",
          "externalId": "text",
          "accountNumber": "text",
          "nickName": "text",
          "country": "ARG",
          "currency": "ARS",
          "financialInstitution": "text",
          "type": "CASH_ACCOUNT",
          "accountHolder": "text",
          "accountHolderDni": "text",
          "createdAt": "text",
          "updatedAt": "text",
          "iban": "text",
          "sortCode": "text"
        },
        "crypto": {
          "address": "text",
          "token": "USDC",
          "network": "ETHEREUM",
          "extendedData": [
            [
              {
                "name": "text",
                "value": "text"
              }
            ]
          ]
        }
      }
    ],
    "originAmount": {
      "amount": "text",
      "currency": "ARS"
    },
    "destinations": [
      {
        "name": "text",
        "type": "text",
        "currency": "ARS",
        "referenceId": "text",
        "processing": "INSTANT_PAYMENT",
        "fee": {
          "name": "text",
          "type": "TRANSACTION",
          "method": "PERCENTAGE",
          "currency": "ARS",
          "value": "text"
        },
        "limits": {
          "minAmount": "text",
          "maxAmount": "text"
        },
        "metaData": {
          "image": "text",
          "title": "text",
          "description": "text"
        },
        "paymentInitiation": {
          "publicKey": "text",
          "widgetLink": "text",
          "signatureToken": "text",
          "origin": {
            "id": "text",
            "identity": "text",
            "externalId": "text",
            "accountNumber": "text",
            "nickName": "text",
            "country": "ARG",
            "currency": "ARS",
            "financialInstitution": "text",
            "type": "CASH_ACCOUNT",
            "accountHolder": "text",
            "accountHolderDni": "text",
            "balances": {
              "balance": "text",
              "availableFunds": "text",
              "accruedYield": "text",
              "monthlyYield": "text"
            },
            "createdAt": "text",
            "updatedAt": "text",
            "iban": "text",
            "sortCode": "text"
          }
        },
        "account": {
          "id": "text",
          "identity": "text",
          "externalId": "text",
          "accountNumber": "text",
          "nickName": "text",
          "country": "ARG",
          "currency": "ARS",
          "financialInstitution": "text",
          "type": "CASH_ACCOUNT",
          "accountHolder": "text",
          "accountHolderDni": "text",
          "createdAt": "text",
          "updatedAt": "text",
          "iban": "text",
          "sortCode": "text"
        },
        "crypto": {
          "address": "text",
          "token": "USDC",
          "network": "ETHEREUM",
          "extendedData": [
            [
              {
                "name": "text",
                "value": "text"
              }
            ]
          ]
        }
      }
    ],
    "destinationAmount": {
      "amount": "text",
      "currency": "ARS"
    },
    "type": "TOPUP_ACCOUNT",
    "product": "text",
    "status": "ATTEMPT",
    "enrich": {
      "merchantCode": "text",
      "merchantName": "text",
      "location": {
        "country": "ARG",
        "administrativeAreaLevel1": "text",
        "administrativeAreaLevel2": "text",
        "administrativeAreaLevel3": "text",
        "street": "text",
        "zipcode": "text",
        "optionalAddress": "text"
      }
    },
    "settlement": "INSTANT",
    "fees": [
      {
        "name": "text",
        "type": "TRANSACTION",
        "method": "PERCENTAGE",
        "currency": "ARS",
        "value": "text"
      }
    ],
    "exchange": {
      "id": "text",
      "type": "SPOT",
      "product": "text",
      "status": "CREATED",
      "origin": {
        "id": "text",
        "identity": "text",
        "externalId": "text",
        "accountNumber": "text",
        "nickName": "text",
        "country": "ARG",
        "currency": "ARS",
        "financialInstitution": "text",
        "type": "CASH_ACCOUNT",
        "accountHolder": "text",
        "accountHolderDni": "text",
        "createdAt": "text",
        "updatedAt": "text",
        "iban": "text",
        "sortCode": "text"
      },
      "destination": {
        "id": "text",
        "externalId": "text",
        "address": "text",
        "token": "USDC",
        "network": "ETHEREUM",
        "type": "HOT",
        "multisigType": "TSS",
        "passphrase": "text",
        "status": "ACTIVE",
        "provider": "CONOMY",
        "keys": {
          "userKeychain": "text",
          "backupKeychain": "text",
          "providerKeychain": "text"
        },
        "extendedData": [
          [
            {
              "name": "text",
              "value": "text"
            }
          ]
        ],
        "createdAt": "text",
        "updatedAt": "text"
      },
      "exchangeRate": "text",
      "fee": "text",
      "executable": true,
      "provider": "text",
      "marketValue": "text",
      "extendedData": [
        {
          "name": "text",
          "value": "text"
        }
      ],
      "createdAt": "text",
      "updatedAt": "text"
    },
    "metaData": {
      "description": "text",
      "image": "text",
      "category": "text"
    },
    "createdAt": "text",
    "updatedAt": "text",
    "expiredAt": "text"
  }'

201

400

500

201

{
  "id": "text",
  "externalId": "text",
  "externalIdentityId": "text",
  "identityId": "text",
  "origins": [
    {
      "name": "text",
      "type": "text",
      "currency": "ARS",
      "referenceId": "text",
      "processing": "INSTANT_PAYMENT",
      "fee": {
        "name": "text",
        "type": "TRANSACTION",
        "method": "PERCENTAGE",
        "currency": "ARS",
        "value": "text"
      },
      "limits": {
        "minAmount": "text",
        "maxAmount": "text"
      },
      "metaData": {
        "image": "text",
        "title": "text",
        "description": "text"
      },
      "paymentInitiation": {
        "publicKey": "text",
        "widgetLink": "text",
        "signatureToken": "text",
        "origin": {
          "id": "text",
          "identity": "text",
          "externalId": "text",
          "accountNumber": "text",
          "nickName": "text",
          "country": "ARG",
          "currency": "ARS",
          "financialInstitution": "text",
          "type": "CASH_ACCOUNT",
          "accountHolder": "text",
          "accountHolderDni": "text",
          "balances": {
            "balance": "text",
            "availableFunds": "text",
            "accruedYield": "text",
            "monthlyYield": "text"
          },
          "createdAt": "text",
          "updatedAt": "text",
          "iban": "text",
          "sortCode": "text"
        }
      },
      "account": {
        "id": "text",
        "identity": "text",
        "externalId": "text",
        "accountNumber": "text",
        "nickName": "text",
        "country": "ARG",
        "currency": "ARS",
        "financialInstitution": "text",
        "type": "CASH_ACCOUNT",
        "accountHolder": "text",
        "accountHolderDni": "text",
        "createdAt": "text",
        "updatedAt": "text",
        "iban": "text",
        "sortCode": "text"
      },
      "crypto": {
        "address": "text",
        "token": "USDC",
        "network": "ETHEREUM",
        "extendedData": [
          [
            {
              "name": "text",
              "value": "text"
            }
          ]
        ]
      }
    }
  ],
  "originAmount": {
    "amount": "text",
    "currency": "ARS"
  },
  "destinations": [
    {
      "name": "text",
      "type": "text",
      "currency": "ARS",
      "referenceId": "text",
      "processing": "INSTANT_PAYMENT",
      "fee": {
        "name": "text",
        "type": "TRANSACTION",
        "method": "PERCENTAGE",
        "currency": "ARS",
        "value": "text"
      },
      "limits": {
        "minAmount": "text",
        "maxAmount": "text"
      },
      "metaData": {
        "image": "text",
        "title": "text",
        "description": "text"
      },
      "paymentInitiation": {
        "publicKey": "text",
        "widgetLink": "text",
        "signatureToken": "text",
        "origin": {
          "id": "text",
          "identity": "text",
          "externalId": "text",
          "accountNumber": "text",
          "nickName": "text",
          "country": "ARG",
          "currency": "ARS",
          "financialInstitution": "text",
          "type": "CASH_ACCOUNT",
          "accountHolder": "text",
          "accountHolderDni": "text",
          "balances": {
            "balance": "text",
            "availableFunds": "text",
            "accruedYield": "text",
            "monthlyYield": "text"
          },
          "createdAt": "text",
          "updatedAt": "text",
          "iban": "text",
          "sortCode": "text"
        }
      },
      "account": {
        "id": "text",
        "identity": "text",
        "externalId": "text",
        "accountNumber": "text",
        "nickName": "text",
        "country": "ARG",
        "currency": "ARS",
        "financialInstitution": "text",
        "type": "CASH_ACCOUNT",
        "accountHolder": "text",
        "accountHolderDni": "text",
        "createdAt": "text",
        "updatedAt": "text",
        "iban": "text",
        "sortCode": "text"
      },
      "crypto": {
        "address": "text",
        "token": "USDC",
        "network": "ETHEREUM",
        "extendedData": [
          [
            {
              "name": "text",
              "value": "text"
            }
          ]
        ]
      }
    }
  ],
  "destinationAmount": {
    "amount": "text",
    "currency": "ARS"
  },
  "type": "TOPUP_ACCOUNT",
  "product": "text",
  "status": "ATTEMPT",
  "enrich": {
    "merchantCode": "text",
    "merchantName": "text",
    "location": {
      "country": "ARG",
      "administrativeAreaLevel1": "text",
      "administrativeAreaLevel2": "text",
      "administrativeAreaLevel3": "text",
      "street": "text",
      "zipcode": "text",
      "optionalAddress": "text"
    }
  },
  "settlement": "INSTANT",
  "fees": [
    {
      "name": "text",
      "type": "TRANSACTION",
      "method": "PERCENTAGE",
      "currency": "ARS",
      "value": "text"
    }
  ],
  "exchange": {
    "id": "text",
    "type": "SPOT",
    "product": "text",
    "status": "CREATED",
    "origin": {
      "id": "text",
      "identity": "text",
      "externalId": "text",
      "accountNumber": "text",
      "nickName": "text",
      "country": "ARG",
      "currency": "ARS",
      "financialInstitution": "text",
      "type": "CASH_ACCOUNT",
      "accountHolder": "text",
      "accountHolderDni": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "iban": "text",
      "sortCode": "text"
    },
    "destination": {
      "id": "text",
      "externalId": "text",
      "address": "text",
      "token": "USDC",
      "network": "ETHEREUM",
      "type": "HOT",
      "multisigType": "TSS",
      "passphrase": "text",
      "status": "ACTIVE",
      "provider": "CONOMY",
      "keys": {
        "userKeychain": "text",
        "backupKeychain": "text",
        "providerKeychain": "text"
      },
      "extendedData": [
        [
          {
            "name": "text",
            "value": "text"
          }
        ]
      ],
      "createdAt": "text",
      "updatedAt": "text"
    },
    "exchangeRate": "text",
    "fee": "text",
    "executable": true,
    "provider": "text",
    "marketValue": "text",
    "extendedData": [
      {
        "name": "text",
        "value": "text"
      }
    ],
    "createdAt": "text",
    "updatedAt": "text"
  },
  "metaData": {
    "description": "text",
    "image": "text",
    "category": "text"
  },
  "createdAt": "text",
  "updatedAt": "text",
  "expiredAt": "text"
}

Represents the comprehensive transaction entity encompassing the entire payment process. It includes details from the initial payment attempt through to the final payment confirmation. It is the primary reference for tracking and managing the lifecycle of a payment within the system.