cURL con datos ficticios

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/funds-recoveries \
  --header 'Authorization: Bearer demo-access-token' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pix-demo-20260903-000001' \
  --data '{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "metadata": "metadata-example",
  "reportDetails": "Victim of a WhatsApp scam",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "trackingGraphParameters": "trackinggraphparameters-example"
}'

import requests

url = "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "contactInformation": {
        "email": "user@example.com",
        "phone": "+5511999999999"
    },
    "metadata": "metadata-example",
    "reportDetails": "Victim of a WhatsApp scam",
    "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
    "situationType": "SCAM",
    "trackingGraphParameters": "trackinggraphparameters-example"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440000',
    contactInformation: {email: 'user@example.com', phone: '+5511999999999'},
    metadata: 'metadata-example',
    reportDetails: 'Victim of a WhatsApp scam',
    rootTransactionId: 'E12345678202605171530aB3xK9mWq2z',
    situationType: 'SCAM',
    trackingGraphParameters: 'trackinggraphparameters-example'
  })
};

fetch('https://api.example.com/dict-hub/v1/dict/funds-recoveries', 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://api.example.com/dict-hub/v1/dict/funds-recoveries",
  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([
    'accountId' => '550e8400-e29b-41d4-a716-446655440000',
    'contactInformation' => [
        'email' => 'user@example.com',
        'phone' => '+5511999999999'
    ],
    'metadata' => 'metadata-example',
    'reportDetails' => 'Victim of a WhatsApp scam',
    'rootTransactionId' => 'E12345678202605171530aB3xK9mWq2z',
    'situationType' => 'SCAM',
    'trackingGraphParameters' => 'trackinggraphparameters-example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$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://api.example.com/dict-hub/v1/dict/funds-recoveries"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	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://api.example.com/dict-hub/v1/dict/funds-recoveries")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/dict-hub/v1/dict/funds-recoveries")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}"

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

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Crear una recuperación de fondos

Se abre una recuperación de fondos de MED 2.0 de forma síncrona. Una creación correcta devuelve HTTP 201 con estado CREATED. La reutilización de una Idempotency-Key devuelve la respuesta original con HTTP 200. Una recuperación duplicada se rechaza con 409 / PIX-0113. Si el timestamp de rootTransactionId está fuera de la ventana de impugnación de MED aplicable, la solicitud se rechaza con 422 / PIX-0117. La ventana se determina según el momento de creación de la recuperación: pacs.008 utiliza 80 días calendario; pacs.004 utiliza 30 días calendario antes de 2026-09-01T00:00:00Z y 80 días calendario desde ese instante. Esta validación del timestamp no confirma que exista la transacción referenciada. El participante se determina a partir del tenant autenticado. participantId, reporterParticipant, rootTransactionType e idempotencyKey se rechazan cuando se incluyen en el cuerpo.

POST

dict

funds-recoveries

cURL con datos ficticios

curl --request POST \
  --url https://api.example.com/dict-hub/v1/dict/funds-recoveries \
  --header 'Authorization: Bearer demo-access-token' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pix-demo-20260903-000001' \
  --data '{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "metadata": "metadata-example",
  "reportDetails": "Victim of a WhatsApp scam",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "trackingGraphParameters": "trackinggraphparameters-example"
}'

import requests

url = "https://api.example.com/dict-hub/v1/dict/funds-recoveries"

payload = {
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "contactInformation": {
        "email": "user@example.com",
        "phone": "+5511999999999"
    },
    "metadata": "metadata-example",
    "reportDetails": "Victim of a WhatsApp scam",
    "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
    "situationType": "SCAM",
    "trackingGraphParameters": "trackinggraphparameters-example"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: '550e8400-e29b-41d4-a716-446655440000',
    contactInformation: {email: 'user@example.com', phone: '+5511999999999'},
    metadata: 'metadata-example',
    reportDetails: 'Victim of a WhatsApp scam',
    rootTransactionId: 'E12345678202605171530aB3xK9mWq2z',
    situationType: 'SCAM',
    trackingGraphParameters: 'trackinggraphparameters-example'
  })
};

fetch('https://api.example.com/dict-hub/v1/dict/funds-recoveries', 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://api.example.com/dict-hub/v1/dict/funds-recoveries",
  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([
    'accountId' => '550e8400-e29b-41d4-a716-446655440000',
    'contactInformation' => [
        'email' => 'user@example.com',
        'phone' => '+5511999999999'
    ],
    'metadata' => 'metadata-example',
    'reportDetails' => 'Victim of a WhatsApp scam',
    'rootTransactionId' => 'E12345678202605171530aB3xK9mWq2z',
    'situationType' => 'SCAM',
    'trackingGraphParameters' => 'trackinggraphparameters-example'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$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://api.example.com/dict-hub/v1/dict/funds-recoveries"

	payload := strings.NewReader("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	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://api.example.com/dict-hub/v1/dict/funds-recoveries")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/dict-hub/v1/dict/funds-recoveries")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"contactInformation\": {\n    \"email\": \"user@example.com\",\n    \"phone\": \"+5511999999999\"\n  },\n  \"metadata\": \"metadata-example\",\n  \"reportDetails\": \"Victim of a WhatsApp scam\",\n  \"rootTransactionId\": \"E12345678202605171530aB3xK9mWq2z\",\n  \"situationType\": \"SCAM\",\n  \"trackingGraphParameters\": \"trackinggraphparameters-example\"\n}"

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

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "bacenFundsRecoveryId": "9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f",
  "contactInformation": {
    "email": "user@example.com",
    "phone": "+5511999999999"
  },
  "correlationId": "7c9e6679742540de944be07fc1f90ae7",
  "createdAt": "2026-05-17T13:30:00Z",
  "id": "018f8c1d-1234-7abc-9def-000000000001",
  "metadata": "metadata-example",
  "participantId": "12345678",
  "reportDetails": "Victim of a WhatsApp scam",
  "reporterParticipant": "12345678",
  "rootTransactionId": "E12345678202605171530aB3xK9mWq2z",
  "situationType": "SCAM",
  "status": "CREATED",
  "trackingGraph": "trackinggraph-example",
  "trackingGraphParameters": "trackinggraphparameters-example",
  "updatedAt": "2026-05-17T13:30:00Z"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

Idempotency-Key

string

requerido

Clave generada por el cliente para reintentar exactamente la misma solicitud de forma segura.

Ejemplo:

"a1b2c3d4-0000-0000-0000-000000000001"

Cuerpo

application/json

accountId

string

requerido

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

contactInformation

object

requerido

Show child attributes

rootTransactionId

string

requerido

Ejemplo:

"E12345678202605171530aB3xK9mWq2z"

situationType

enum<string>

requerido

Opciones disponibles:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Ejemplo:

"SCAM"

metadata

any

reportDetails

string

Ejemplo:

"Victim of a WhatsApp scam"

trackingGraphParameters

any

Respuesta

Idempotent replay: a repeated Idempotency-Key returns the funds recovery created by the first request (cached response body).

accountId

string

requerido

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

bacenFundsRecoveryId

string

requerido

Ejemplo:

"9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f"

contactInformation

object

requerido

Show child attributes

createdAt

string<date-time>

requerido

Ejemplo:

"2026-05-17T13:30:00Z"

string

requerido

Ejemplo:

"018f8c1d-1234-7abc-9def-000000000001"

participantId

string

requerido

Ejemplo:

"12345678"

reporterParticipant

string

requerido

Ejemplo:

"12345678"

rootTransactionId

string

requerido

Ejemplo:

"E12345678202605171530aB3xK9mWq2z"

situationType

enum<string>

requerido

Opciones disponibles:

SCAM,

ACCOUNT_TAKEOVER,

COERCION,

FRAUDULENT_ACCESS,

OTHER,

UNKNOWN

Ejemplo:

"SCAM"

status

enum<string>

requerido

Opciones disponibles:

CREATED,

TRACKED,

AWAITING_ANALYSIS,

ANALYSED,

REFUNDING,

COMPLETED,

CANCELLED

Ejemplo:

"CREATED"

updatedAt

string<date-time>

requerido

Ejemplo:

"2026-05-17T13:30:00Z"

correlationId

string

Ejemplo:

"7c9e6679742540de944be07fc1f90ae7"

metadata

any

reportDetails

string

Ejemplo:

"Victim of a WhatsApp scam"

trackingGraph

any

trackingGraphParameters

any

Pix — Lerian SPI (mensajería nativa)

Pix Lerian

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado — Dataprev

Crear una recuperación de fondos

Autorizaciones

Encabezados

Cuerpo

Respuesta