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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 50000,
    'symbolOrigin' => 'COP',
    'symbolDestination' => 'USDC',
    'paymentMethod' => 'PSE',
    'bankCode' => '1303',
    'destination' => [
        'type' => 'EXTERNAL',
        'externalWalletId' => '{{external_wallet_id}}'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}"

response = http.request(request)
puts response.read_body

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

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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 50000,
    'symbolOrigin' => 'COP',
    'symbolDestination' => 'USDC',
    'paymentMethod' => 'PSE',
    'bankCode' => '1303',
    'destination' => [
        'type' => 'EXTERNAL',
        'externalWalletId' => '{{external_wallet_id}}'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/onramp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 50000,\n  \"symbolOrigin\": \"COP\",\n  \"symbolDestination\": \"USDC\",\n  \"paymentMethod\": \"PSE\",\n  \"bankCode\": \"1303\",\n  \"destination\": {\n    \"type\": \"EXTERNAL\",\n    \"externalWalletId\": \"{{external_wallet_id}}\"\n  }\n}"

response = http.request(request)
puts response.read_body

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

Guides

API reference

Create On-Ramp

Request

Request Body

Response

Errors

Authorizations

Path Parameters

Body

Response