Confirmar un desembolso ya pagado al trabajador

curl --request POST \
  --url https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "amount": "2000.00",
  "paid_at": "2026-08-01T12:00:00Z",
  "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}
'

import requests

url = "https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation"

payload = {
    "amount": "2000.00",
    "paid_at": "2026-08-01T12:00:00Z",
    "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '2000.00',
    paid_at: '2026-08-01T12:00:00Z',
    payment_reference: 'E32074986202608011200A1B2C3D4E5F'
  })
};

fetch('https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation', 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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation",
  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' => '2000.00',
    'paid_at' => '2026-08-01T12:00:00Z',
    'payment_reference' => 'E32074986202608011200A1B2C3D4E5F'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation"

	payload := strings.NewReader("{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation")

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

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}"

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

{
  "amount": "2000.00",
  "confirmation_id": "1f5b9c26-6f5a-4f77-9c1c-5d1c0f0a9b21",
  "confirmed_at": "2026-08-01T12:00:05Z",
  "numero_contrato": "99999999999AN1",
  "paid_at": "2026-08-01T12:00:00Z",
  "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}

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

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

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

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

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

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

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

Confirmar un desembolso ya pagado al trabajador

Registra el hecho duradero propio de la pasarela de que un banco cliente ya pagó a un trabajador. No es una operación de Dataprev: no se utiliza ninguna credencial de red, no se cruza ningún límite gubernamental y Dataprev no publica ninguna operación de confirmación de desembolso mediante proxy. La pasarela registra lo que afirmó el cliente; no consulta a ningún producto posterior si el pago es plausible.

Acepta confirmaciones huérfanas (dinero para un contrato que esta implementación nunca registró localmente), y un contrato puede desembolsarse en más de un pago. La identidad de una confirmación es (tenant, numero_contrato, payment_reference), por lo que un segundo pago con una referencia diferente en el mismo contrato es una primera aceptación con su propio hecho, nunca un conflicto.

X-Idempotency es obligatorio, opaco, de 1 a 128 bytes y nunca está predeterminado. Dos claves que difieren en un byte son dos claves y no existe un alias X-Idempotency-Key.

caso	estado	X-Idempotency-Replayed
primera aceptación	202	ausente
misma clave, misma solicitud, atendida desde la caché de transporte	202, los bytes idénticos	true
misma clave, misma solicitud, atendida desde la autoridad duradera	202, los bytes idénticos	ausente
misma clave, solicitud divergente	422 — nunca el cuerpo anterior	lo que sea que escribió el middleware compartido
nueva clave, mismo pago	202, el mismo cuerpo	ausente
nueva clave, misma referencia de pago, diferente dinero	409	lo que sea que escribió el middleware compartido

PostgreSQL es la autoridad de cada fila. La caché de idempotencia de transporte es un acelerador de mejor esfuerzo sobre ella, en ambos sentidos: tanto si la caché falla antes de que se decida la solicitud como si falla después de que la confirmación ya esté confirmada, la respuesta procede de la autoridad duradera y la única diferencia en la comunicación es que el encabezado de repetición está ausente. Una falla de caché nunca convierte un pago registrado en un 503. Es una falla distinta de una interrupción compartida de Redis, que el limitador de tarifas del tenant rechaza primero.

POST

consignado

contracts

{numero_contrato}

disbursement-confirmation

Confirmar un desembolso ya pagado al trabajador

curl --request POST \
  --url https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "amount": "2000.00",
  "paid_at": "2026-08-01T12:00:00Z",
  "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}
'

import requests

url = "https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation"

payload = {
    "amount": "2000.00",
    "paid_at": "2026-08-01T12:00:00Z",
    "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '2000.00',
    paid_at: '2026-08-01T12:00:00Z',
    payment_reference: 'E32074986202608011200A1B2C3D4E5F'
  })
};

fetch('https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation', 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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation",
  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' => '2000.00',
    'paid_at' => '2026-08-01T12:00:00Z',
    'payment_reference' => 'E32074986202608011200A1B2C3D4E5F'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation"

	payload := strings.NewReader("{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://consignado.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/disbursement-confirmation")

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

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"2000.00\",\n  \"paid_at\": \"2026-08-01T12:00:00Z\",\n  \"payment_reference\": \"E32074986202608011200A1B2C3D4E5F\"\n}"

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

{
  "amount": "2000.00",
  "confirmation_id": "1f5b9c26-6f5a-4f77-9c1c-5d1c0f0a9b21",
  "confirmed_at": "2026-08-01T12:00:05Z",
  "numero_contrato": "99999999999AN1",
  "paid_at": "2026-08-01T12:00:00Z",
  "payment_reference": "E32074986202608011200A1B2C3D4E5F"
}

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

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

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

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

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

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

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

X-Idempotency

string

requerido

Mandatory opaque replay key, 1..128 bytes of valid UTF-8, preserved byte for byte. There is no default, no X-Idempotency-Key alias, no case folding and no normalization: two keys differing in one byte are two keys.

Required string length: 1 - 128

Ejemplo:

"idem-desembolso-0001"

Parámetros de ruta

numero_contrato

string

requerido

The rail contract number the money was paid against (Manual 004 §2.2.2 p.18: Texto, 15). Exact, control-free UTF-8, bounded in BYTES: no trimming and no case folding. Nothing looks it up — an orphan confirmation for a contract this deployment never registered is first-class.

Required string length: 1 - 15

Ejemplo:

"99999999999AN1"

Cuerpo

application/json

amount

string

requerido

The BRL amount already paid to the worker, as a canonical positive decimal string matching ^[1-9][0-9]*.[0-9]{2}$ (at most 13 bytes). A string, never a JSON number: money never passes through a float.

Maximum string length: 13

Ejemplo:

"2000.00"

paid_at

string

requerido

When the money was paid, strict RFC 3339 UTC with a literal Z (2026-08-01T12:00:00Z). Exactly one spelling per instant: a +00:00 offset, a lowercase z, fractional seconds or a missing zone are refused, never normalized.

Maximum string length: 20

Ejemplo:

"2026-08-01T12:00:00Z"

payment_reference

string

requerido

The client's opaque payment reference — a Pix EndToEndId, a TED protocol number, an internal settlement id. Valid UTF-8, 1..256 bytes, preserved byte for byte with no trimming, case folding or normalization.

Maximum string length: 256

Ejemplo:

"E32074986202608011200A1B2C3D4E5F"

Respuesta

The confirmation is durably recorded. A replay of the same payment — under the same key or a new one — answers with the identical body.

amount

string

requerido

The confirmed amount, echoed verbatim.

Ejemplo:

"2000.00"

confirmation_id

string

requerido

The gateway's identity for this immutable confirmation.

Ejemplo:

"1f5b9c26-6f5a-4f77-9c1c-5d1c0f0a9b21"

confirmed_at

string

requerido

When the gateway durably recorded the confirmation, strict RFC 3339 UTC.

Ejemplo:

"2026-08-01T12:00:05Z"

numero_contrato

string

requerido

The rail contract number the confirmation was addressed to, echoed from the path.

Ejemplo:

"99999999999AN1"

paid_at

string

requerido

When the money was paid, echoed verbatim.

Ejemplo:

"2026-08-01T12:00:00Z"

payment_reference

string

requerido

The client's payment reference, echoed verbatim.

Ejemplo:

"E32074986202608011200A1B2C3D4E5F"

⌘I

Pix — Lerian SPI (mensajería nativa)

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

Confirmar un desembolso ya pagado al trabajador

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta