Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-07-2642128296.2 KB
Payables

Validate a signature without persisting

Verifies the JWS signature of a signed envelope against the sender's certificates without persisting anything — useful to test the signing setup before sending real payables. Mirrors POST /payout_orders/validate_signature.

Responds 200 when the signature is valid, and 404 when it is not (or when the sender fin_id is unknown or not owned by the caller — no existence leak). A malformed envelope — one that carries no document.header.sender.fin_id — is a 422 instead: there is nothing to resolve the sender against.

post/payables/validate_signature

Request body

Example request

{
  "document": {
    "header": {
      "message_id": "014a74cb-597c-46a1-8217-63e58a336b0d",
      "creation_date": "2026-07-15T18:25:43-04:00",
      "sender": {
        "fin_id_schema": "SHINKANSEN",
        "fin_id": "BUK"
      },
      "receiver": {
        "fin_id_schema": "SHINKANSEN",
        "fin_id": "SHINKANSEN_TREASURY"
      }
    },
    "payables": [
      {
        "external_id": "RD-2026-000123",
        "payable_type": "redemption",
        "amount": "150000",
        "currency": "CLP",
        "state": "waiting_order",
        "due_date": "2026-07-20",
        "description": "Redemption settlement - fund A",
        "dispatch_policy": "automatic",
        "execution_hint": "internal",
        "debtor": {
          "financial_institution": {
            "fin_id_schema": "SHINKANSEN",
            "fin_id": "BANCO_BICE_CL"
          },
          "account": "123451",
          "account_type": "current_account"
        },
        "creditor": {
          "name": "Romulo Gallegos",
          "email": "romulo.gallegos@example.com",
          "account": "1513523451",
          "account_type": "current_account",
          "identification": {
            "id_schema": "CLID",
            "id": "12383287-6"
          },
          "financial_institution": {
            "fin_id_schema": "SHINKANSEN",
            "fin_id": "SCOTIABANK_CL"
          }
        }
      }
    ]
  }
}

Response

The JWS signature is valid.

messagestring

Example response

{
  "message": "valid signature"
}