1. V3 - Signature Request
Cresium
  • Cresium - V3 Partners
    • API
      • Auth Information for V3 API Partners
      • V3 - Health
        • Health check
      • V3 - Transaction
        • Get Transaction data
        • Search transactions
        • Make a transfer
        • Confirm a transaction
        • Reverse a deposit transaction
        • Get transaction receipt
      • V3 - BankAddress
        • Get Address
      • V3 - CompanyFeature
        • Get Company Features
        • Update Feature Enabled State
      • V3 - Rate
        • Get TNA rate
      • V3 - DepositAddress
        • Update Deposit Address
        • Create Deposit Address
      • V3 - Invoice
        • Create Invoices
        • Read Invoices
      • V3 - Partner
        • Search partner transactions
      • V3 - User Address
        • Create or get User Address
      • V3 - Auth
        • V3 - Balance
          • Get all wallets for Company
        • Generate change password ID for partner user
      • V3 - CompanyTax
        • Upsert Company Tax
      • V3 - Signature Request
        • Create Signature Request
          POST
        • Update Signature Request
          PUT
      • V3 - Payment
        • Create Payments
        • Read Payments
      • Webhooks
        • Auth Information for Webhooks
        • Transactions Events Examples - DEPOSIT
  1. V3 - Signature Request

Create Signature Request

POST
/v3/signature-request/{type}
Crea una solicitud de firma para una operacion existente en estado PREVIEW.

Caso de uso#

Cuando una transaccion requiere aprobacion de un signer antes de ejecutarse, en lugar de
confirmarla directamente con PUT /v3/transaction/confirm/:id, se crea una Signature Request.
Esto envia una notificacion a los signers de la company para que aprueben la operacion desde el Dashboard.

Parametros#

type (path): Tipo de solicitud de firma
ValorDescripcion
TRANSACTION_REQUESTPara transacciones individuales (WITHDRAWAL, BILL_PAYMENT)
BULK_REQUESTPara transacciones masivas
PAYROLL_REQUESTPara liquidaciones de sueldo

Body Parameters#

CampoTipoRequeridoDescripcion
idnumberSiID de la entidad a firmar (transaccion, bulk, payroll)

Flujo tipico para transferencias#

1.
Crear transferencia: POST /v3/transaction/preview -> obtener transaction.id
2.
Crear Signature Request: POST /v3/signature-request/TRANSACTION_REQUEST con { "id": transaction.id }
3.
Los signers de la company reciben notificacion
4.
Cuando un signer aprueba desde el Dashboard, la transaccion se confirma automaticamente

Validaciones#

La transaccion debe estar en estado PREVIEW
La transaccion debe ser de tipo WITHDRAWAL o BILL_PAYMENT
La company debe ser duena de la transaccion

Respuesta#

Retorna true si la solicitud se creo exitosamente.

Errores posibles#

INVALID_TRANSACTION: La transaccion no esta en estado PREVIEW o no es WITHDRAWAL/BILL_PAYMENT
NOT_OWNER: La company no es duena de la entidad
NOT_FOUND: La entidad no existe

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Successful response
Body

🟠400
🟠401
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.develop.cresium.app/v3/signature-request/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 0
}'
Response Response Example
200 - Example 1
{
    "data": true
}
Modified at 2026-02-20 14:08:41
Previous
V3 - Signature Request
Next
Update Signature Request
Built with