Create On-Ramp

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000,
  "symbolOrigin": "COP",
  "symbolDestination": "USDC",
  "paymentMethod": "PSE",
  "bankCode": "1303",
  "destination": {
    "type": "EXTERNAL",
    "externalWalletId": "{{external_wallet_id}}"
  }
}
'

import requests

url = "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp"

payload = {
    "amount": 50000,
    "symbolOrigin": "COP",
    "symbolDestination": "USDC",
    "paymentMethod": "PSE",
    "bankCode": "1303",
    "destination": {
        "type": "EXTERNAL",
        "externalWalletId": "{{external_wallet_id}}"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 50000,
    symbolOrigin: 'COP',
    symbolDestination: 'USDC',
    paymentMethod: 'PSE',
    bankCode: '1303',
    destination: {type: 'EXTERNAL', externalWalletId: '{{external_wallet_id}}'}
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "operation": {
    "id": "567e0559-2301-42ab-a865-d8763dea3888",
    "userId": "c9a26b49-7b71-44e5-8fdf-03ec6a2a7267",
    "type": "CUSTODY",
    "custodyType": "SELF_CUSTODY",
    "prefix": "NPO",
    "numberCode": 96545,
    "originId": "5c3fa520-adbb-49aa-a95b-018c13db79e3",
    "destinationId": "dfa1bb42-74b7-4dab-b52b-0ec2e26253db",
    "symbolOrigin": "USDC",
    "symbolDestination": "USD",
    "amountOrigin": 200,
    "amountDestination": 175,
    "rate": 1,
    "paymentMethod": "WIRE",
    "registerDate": "2026-06-23T09:32:10.944107",
    "status": "PENDING",
    "direction": "WITHDRAWAL",
    "depositInstructions": null,
    "metadataItems": null,
    "events": null,
    "treasuryItems": [
      {
        "id": "b733d7d8-5162-4dc9-a786-422265d0bfa5",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "realRate",
        "amount": 1,
        "showClient": false
      },
      {
        "id": "9f9b6abc-09d9-4a78-b4a6-8991f2979be0",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "MinAmount",
        "amount": 50,
        "showClient": false
      },
      {
        "id": "fb0d7a71-739c-40a9-abbc-6089c4149d4c",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "CostInfra",
        "amount": 25,
        "showClient": true
      },
      {
        "id": "e6c08f41-78c2-4c6b-b7e9-f6bbd6fc4f21",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "spread",
        "amount": 0,
        "showClient": false
      },
      {
        "id": "842f57f1-44aa-46ea-84ea-2b5c8524135a",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "calculateRate",
        "amount": 1,
        "showClient": true
      },
      {
        "id": "85c17fc1-aaed-4351-be64-1046dedd867b",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "amountReceive",
        "amount": 175,
        "showClient": true
      }
    ]
  },
  "tierEscalation": null
}

Liquidity Ramps

Create On-Ramp

Creates an on-ramp: the user pays in fiat (COP) and receives the stablecoin in a registered external wallet.

Request

Field	Type	Required	Description
Authorization	Header	Yes	`Bearer <access_token>` obtained from POST /api/v1/client/token.
user_id	Path	Yes	User who pays and receives the funds.

Request Body

Field	Type	Required	Description
amount	number	Yes	Amount of the operation, in COP.
symbolOrigin	string	No	Fiat paid (`COP`).
symbolDestination	string	No	Stablecoin delivered (e.g. `USDC`).
paymentMethod	string	No	`PSE`, `NEQUI` or `DAVIPLATA`. Defaults to `DAVIPLATA`.
bankCode	string	No	Bank `code` from GET /admin/banks. Required for `PSE`.
bankName	string	No	Bank name, for `PSE`.
redirectUrl	string	No	Where the user returns after paying (`PSE`).
phone	string	No	Phone number of the user, for `NEQUI` / `DAVIPLATA`.
destination	object	Yes	`{"type": "EXTERNAL", "externalWalletId": "<uuid>"}`. The external wallet must be registered and `APPROVED`.
executionMode	string	No	`NORMAL` (default) or `INVERSE`.
developerFee	number	No	Additional fee you charge your user.

Response

The response is an envelope with three keys:

Field	Description
operation	The created operation: `id`, `userId`, `numberCode`, `originId`, `destinationId`, `symbolOrigin`, `symbolDestination`, `amountOrigin`, `amountDestination`, `rate`, `paymentMethod`, `status`, `direction`, `registerDate`, `depositInstructions`, `treasuryItems` (cost breakdown) and `events`.
tierEscalation	`null` when the operation fits the user’s current compliance tier. Otherwise it describes the action the user must complete to raise their limits (`actionType`: `FORM_URL`, `QR_APP`, `VIDEO_KYC`, `DOC_UPLOAD`, `NOTIFY_ONLY` or `BLOCK`, plus `actionPayload`, `message` and `expiresAt`).
depositInfo	Present when the user has to send funds: `paymentMethod`, the applied `quote` and the `depositInstructions`. `null` otherwise.

Errors

Status	When
400	Insufficient funds in the origin.
403	The user does not exist or is not `APPROVED`.
422	Invalid body, amount ≤ 0, asset pair not enabled for your account, destination not registered/approved/owned by the user, or the operation exceeds the user’s compliance tier limits.

POST

api

admin

operation

{user_id}

onramp

Create On-Ramp

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000,
  "symbolOrigin": "COP",
  "symbolDestination": "USDC",
  "paymentMethod": "PSE",
  "bankCode": "1303",
  "destination": {
    "type": "EXTERNAL",
    "externalWalletId": "{{external_wallet_id}}"
  }
}
'

import requests

url = "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp"

payload = {
    "amount": 50000,
    "symbolOrigin": "COP",
    "symbolDestination": "USDC",
    "paymentMethod": "PSE",
    "bankCode": "1303",
    "destination": {
        "type": "EXTERNAL",
        "externalWalletId": "{{external_wallet_id}}"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 50000,
    symbolOrigin: 'COP',
    symbolDestination: 'USDC',
    paymentMethod: 'PSE',
    bankCode: '1303',
    destination: {type: 'EXTERNAL', externalWalletId: '{{external_wallet_id}}'}
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "operation": {
    "id": "567e0559-2301-42ab-a865-d8763dea3888",
    "userId": "c9a26b49-7b71-44e5-8fdf-03ec6a2a7267",
    "type": "CUSTODY",
    "custodyType": "SELF_CUSTODY",
    "prefix": "NPO",
    "numberCode": 96545,
    "originId": "5c3fa520-adbb-49aa-a95b-018c13db79e3",
    "destinationId": "dfa1bb42-74b7-4dab-b52b-0ec2e26253db",
    "symbolOrigin": "USDC",
    "symbolDestination": "USD",
    "amountOrigin": 200,
    "amountDestination": 175,
    "rate": 1,
    "paymentMethod": "WIRE",
    "registerDate": "2026-06-23T09:32:10.944107",
    "status": "PENDING",
    "direction": "WITHDRAWAL",
    "depositInstructions": null,
    "metadataItems": null,
    "events": null,
    "treasuryItems": [
      {
        "id": "b733d7d8-5162-4dc9-a786-422265d0bfa5",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "realRate",
        "amount": 1,
        "showClient": false
      },
      {
        "id": "9f9b6abc-09d9-4a78-b4a6-8991f2979be0",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "MinAmount",
        "amount": 50,
        "showClient": false
      },
      {
        "id": "fb0d7a71-739c-40a9-abbc-6089c4149d4c",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "CostInfra",
        "amount": 25,
        "showClient": true
      },
      {
        "id": "e6c08f41-78c2-4c6b-b7e9-f6bbd6fc4f21",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "spread",
        "amount": 0,
        "showClient": false
      },
      {
        "id": "842f57f1-44aa-46ea-84ea-2b5c8524135a",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "calculateRate",
        "amount": 1,
        "showClient": true
      },
      {
        "id": "85c17fc1-aaed-4351-be64-1046dedd867b",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "amountReceive",
        "amount": 175,
        "showClient": true
      }
    ]
  },
  "tierEscalation": null
}

Authorizations

Authorization

string

header

required

Access token from POST /api/v1/client/token.

Path Parameters

user_id

string<uuid>

required

Body

application/json

amount

integer

symbolOrigin

string

symbolDestination

string

paymentMethod

string

bankCode

string

destination

object

Show child attributes

Response

200 - application/json

operation

object

Show child attributes

tierEscalation

any

Guides

API reference

Create On-Ramp

Request

Request Body

Response

Errors

Authorizations

Path Parameters

Body

Response