API Reference / Payment Attempts REST

Actions

Retrieves a payment attempt by ID.

GET/payment-attempts/{id}

Get payment-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.

Path parameters

idstringrequired

Unique identifier for the payment-attempt.

Responses

200Request processed 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

The current status of the transaction (e.g., PENDING, AUTHORIZED, CAPTURED, ATTEMPT, REFUNDED).

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.

Request

HTTPcurlTypeScriptPythonGoRust

GET /sandbox/payment-attempts/{id} 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-attempts/{id}' \
  -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-attempts/{id}', {
  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-attempts/{id}',
    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-attempts/{id}", 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-attempts/{id}")
        .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

{
  "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
}