Connections

Disconnect

End a connection. The AgentPay key is destroyed first, the saved session is deleted, and the entry at the merchant is removed when AgentPay can. Idempotent.

DELETE/v1/connections/{id}

Authorization: Bearerid

Live API. A POST to /v1/cards issues a real card.

Authorizations

Authorizationstringrequired

Bearer token: Authorization: Bearer mk_live_.... Create a key in the AgentPay console under Developer, API keys.

Path parameters

idstringrequired

The connection id.

Response200application/json

connection_idstring

statusstring

removing while the passkey is being removed at the merchant, removed otherwise.

passkey_statusstring

removing, then on a later read removed or removed_locally (the person removes the AgentPay-... entry in the merchant's security settings themselves).

request_idstring

The request id, also in the X-Mooj-Request-Id header.

Errors

Status	Code	When
404	`connection_not_found`	No such connection on your account.
502	`disconnect_failed`	The passkey could not be revoked. Retry.

Disconnect

curl -X DELETE https://api.joomjoo.com/v1/connections/conn_5d2b... \
  -H "Authorization: Bearer $AGENTPAY_API_KEY"

const res = await fetch("https://api.joomjoo.com/v1/connections/conn_5d2b...", {
  method: "DELETE",
  headers: { Authorization: "Bearer " + process.env.AGENTPAY_API_KEY },
});
const data = await res.json();

import os, requests

res = requests.delete(
    "https://api.joomjoo.com/v1/connections/conn_5d2b...",
    headers={"Authorization": "Bearer " + os.environ["AGENTPAY_API_KEY"]},
)
data = res.json()

200

{
  "connection_id": "conn_5d2b...",
  "status": "removing",
  "passkey_status": "removing",
  "request_id": "req_a1b2c3"
}