Transfer between accounts

Use P2P when both sides of the movement are internal Conomy accounts. This is for balance transfers, operator-to-operator flows, or internal reallocations. It is not a customer checkout flow.

Attention

Use PURCHASE for a commercial customer payment. Use P2P only when the origin and destination accounts are both known internal accounts.

Flow

01

Choose origin

Pick the account that sends funds.

02

Choose destination

Pick the account that receives funds.

03

Create payment

Create a P2P transaction.

04

Capture

Commit the internal movement.

Create the transfer

Request

HTTPcurlJavaScriptPythonGoRust

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

{
  "externalId": "p2p-transfer-1001",
  "identityId": "<ORIGIN_IDENTITY_ID>",
  "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
  "product": "COP:COP",
  "type": "P2P",
  "purchaseAmount": "15000.00",
  "purchaseCurrency": "COP",
  "currency": "COP",
  "origins": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<ORIGIN_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
      }
    }
  ],
  "destinations": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<DESTINATION_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
      }
    }
  ]
}

curl -X POST 'https://api.conomyhq.com/sandbox/payments' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'User-Agent: MyApp/1.0' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "externalId": "p2p-transfer-1001",
    "identityId": "<ORIGIN_IDENTITY_ID>",
    "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
    "product": "COP:COP",
    "type": "P2P",
    "purchaseAmount": "15000.00",
    "purchaseCurrency": "COP",
    "currency": "COP",
    "origins": [
      {
        "type": "ACCOUNT",
        "amount": "15000.00",
        "currency": "COP",
        "identity": {
          "identityId": "<ORIGIN_IDENTITY_ID>"
        },
        "account": {
          "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
        }
      }
    ],
    "destinations": [
      {
        "type": "ACCOUNT",
        "amount": "15000.00",
        "currency": "COP",
        "identity": {
          "identityId": "<DESTINATION_IDENTITY_ID>"
        },
        "account": {
          "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
        }
      }
    ]
  }'

const response = await fetch('https://api.conomyhq.com/sandbox/payments', {
  method: 'POST',
  headers: {
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    "externalId": "p2p-transfer-1001",
    "identityId": "<ORIGIN_IDENTITY_ID>",
    "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
    "product": "COP:COP",
    "type": "P2P",
    "purchaseAmount": "15000.00",
    "purchaseCurrency": "COP",
    "currency": "COP",
    "origins": [
      {
        "type": "ACCOUNT",
        "amount": "15000.00",
        "currency": "COP",
        "identity": {
          "identityId": "<ORIGIN_IDENTITY_ID>"
        },
        "account": {
          "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
        }
      }
    ],
    "destinations": [
      {
        "type": "ACCOUNT",
        "amount": "15000.00",
        "currency": "COP",
        "identity": {
          "identityId": "<DESTINATION_IDENTITY_ID>"
        },
        "account": {
          "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
        }
      }
    ]
  }),
});

const data = await response.json();

import requests

payload = {
  "externalId": "p2p-transfer-1001",
  "identityId": "<ORIGIN_IDENTITY_ID>",
  "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
  "product": "COP:COP",
  "type": "P2P",
  "purchaseAmount": "15000.00",
  "purchaseCurrency": "COP",
  "currency": "COP",
  "origins": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<ORIGIN_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
      }
    }
  ],
  "destinations": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<DESTINATION_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
      }
    }
  ]
}

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

data = response.json()

package main

import (
	"bytes"
	"net/http"
)

func main() {
	payload := []byte(`{
  "externalId": "p2p-transfer-1001",
  "identityId": "<ORIGIN_IDENTITY_ID>",
  "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
  "product": "COP:COP",
  "type": "P2P",
  "purchaseAmount": "15000.00",
  "purchaseCurrency": "COP",
  "currency": "COP",
  "origins": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<ORIGIN_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
      }
    }
  ],
  "destinations": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<DESTINATION_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
      }
    }
  ]
}`)
	body := bytes.NewReader(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/payments", body)
	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("Content-Type", "application/json")
	req.Header.Set("Accept", "application/json")

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

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

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let payload = json!({
  "externalId": "p2p-transfer-1001",
  "identityId": "<ORIGIN_IDENTITY_ID>",
  "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>",
  "product": "COP:COP",
  "type": "P2P",
  "purchaseAmount": "15000.00",
  "purchaseCurrency": "COP",
  "currency": "COP",
  "origins": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<ORIGIN_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<ORIGIN_ACCOUNT_NUMBER>"
      }
    }
  ],
  "destinations": [
    {
      "type": "ACCOUNT",
      "amount": "15000.00",
      "currency": "COP",
      "identity": {
        "identityId": "<DESTINATION_IDENTITY_ID>"
      },
      "account": {
        "accountNumber": "<DESTINATION_ACCOUNT_NUMBER>"
      }
    }
  ]
});

    let response = client
        .post("https://api.conomyhq.com/sandbox/payments")
        .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("Content-Type", "application/json")
        .header("Accept", "application/json")
        .json(&payload)
        .send()
        .await?;

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

Response

200

{
  "id": "<PAYMENT_ID>",
  "type": "P2P",
  "status": "CREATED"
}

Capture

Request

HTTPcurlJavaScriptPythonGoRust

POST /sandbox/payments/{PAYMENT_ID}/captured 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
Content-Type: application/json
Accept: application/json

{}

curl -X POST 'https://api.conomyhq.com/sandbox/payments/{PAYMENT_ID}/captured' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'User-Agent: MyApp/1.0' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{}'

const response = await fetch('https://api.conomyhq.com/sandbox/payments/{PAYMENT_ID}/captured', {
  method: 'POST',
  headers: {
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

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

data = response.json()

package main

import (
	"bytes"
	"net/http"
)

func main() {
	payload := []byte(`{}`)
	body := bytes.NewReader(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/payments/{PAYMENT_ID}/captured", body)
	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("Content-Type", "application/json")
	req.Header.Set("Accept", "application/json")

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

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

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let payload = json!({});

    let response = client
        .post("https://api.conomyhq.com/sandbox/payments/{PAYMENT_ID}/captured")
        .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("Content-Type", "application/json")
        .header("Accept", "application/json")
        .json(&payload)
        .send()
        .await?;

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

Response

200

{
  "id": "<PAYMENT_ID>",
  "type": "P2P",
  "status": "CAPTURED"
}