Kuenta Docs

Appearance

Obtener enlace de pago por referencia​

GET
/payment-links/{ref}

Get payment link by reference. This endpoint is public and does not require authentication.

Response varies by authentication:

  • Unauthenticated users: Receive public version with only non-sensitive fields (ref, routeUrl, amount, time, expiration, description, redirectUrl, creditLine)
  • Authenticated owner: Receive full payment link object including sensitive fields (entityId, callbackUrl, idNumber, tags, templates)
  • Authenticated non-owner: Receive public version (same as unauthenticated)

The creditLine field is included when available, regardless of authentication status.

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Header Parameters

Config-Organization-ID

Entity ID (optional, used to determine if user is owner)

Typestring
Organization-ID

Entity ID (optional, used to determine if user is owner)

Typestring

Path Parameters

ref*

Payment link reference

Typestring
Required

Responses​

Successful response. Response content varies based on authentication and ownership.
application/json
JSON
{
"data": {
"link": {
"id": "fa861fe7-dd52-469f-bbd3-db57e63ef821",
"createdAt": "2023-01-23T20:03:41.843188Z",
"expiration": null,
"amount": 123123,
"time": 540,
"creditLineId": "860b165d-c9f8-432f-b763-09e336caf948",
"ref": "-GEJUBT4G",
"routeUrl": "https://example.localhost:8100/o/-GEJUBT4G",
"entityId": "b83d54aa-f09e-4c4f-9751-5560f28f4a27",
"redirectUrl": "",
"callbackUrl": "",
"description": "",
"idNumber": "",
"tags": null,
"templates": null,
"creditLine": {
"id": "860b165d-c9f8-432f-b763-09e336caf948",
"productType": 0,
"name": "Línea de crédito personal",
"title": "Crédito personal",
"description": "Línea de crédito para personas naturales",
"timeMin": 30,
"timeMax": 360,
"principalMin": "100000",
"principalMax": "50000000"
}
}
}
}

Playground​

Server
Authorization
Headers
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI