Update a signer

PUT

signer

{signerAddress}

{
  "signer_id": "0195b009-a139-7ff2-adac-15e3c3ecfc88",
  "id": "0195b009-a139-7ff2-adac-15e3c3ecfc88",
  "handle": "wYe6h63CNqoLxJet5jP1WWLhGi8D11ZGij",
  "keeper": [
    {
      "public": "7ef44ee7ff1f4527ef44ee7ff1f4527ef44ee7ff1f4527ef44ee7ff1f4527ef4",
      "scheme": "ecdsa-ed25519",
      "secret": "046d541aec939b4748943e49cc1117a70966a6fc87345e6052a54f1e69ea48d5"
    }
  ],
  "labels": {
    "type": "PERSON",
    "status": "INACTIVE",
    "created": "2025-03-19T15:12:55.993-05:00",
    "updated": "2025-03-20T15:12:55.993-05:00",
    "createdBy": "mSJkneiASd",
    "aliasType": "ALPHANUM",
    "aliasValue": "@jorge",
    "proprietary": "CC",
    "identification": "1010101010",
    "firstName": "Jorge",
    "lastName": "Diaz",
    "bankId": "900123456",
    "bankAccountType": "SVGS",
    "bankAccountNumber": "4123456789",
    "routerReference": "$bancorojo",
    "targetSpbviCode": "TFY",
    "consented": "2025-03-13T20:38:07-05:00",
    "received": "2025-03-13T20:38:07.123-05:00",
    "dispatched": "2025-03-13T20:38:10.123-05:00"
  }
}

Path Parameters

signerAddress

string

required

Body

application/json

labels

object

labels.type

enum<string>

Type of a signer

Available options:

PERSON,

BUSINESS

labels.aliasType

enum<string>

Alias type of the signer

Available options:

ALPHANUM,

EMAIL,

MERCHANT,

PHONE,

NRIC

labels.aliasValue

string

Value of the alias. The format of the alias depends on the aliasType:

"ALPHANUM": Starts with @. Max 20 and min 5 alphanumeric characters after the @.
"EMAIL": Max 92 characters, must contain only one @. Max 30 characters before the @ and 61 after.
"MERCHANT": Starts with 00 and contains 10 characrters in total.
"PHONE": Starts with 3 and contains 9 numbers after.
"NRIC": Max 18 and min 3 alphanumeric characters.

Required string length: 3 - 92

labels.proprietary

enum<string>

'Proprietary label of the signer'

"CC": Cédula de Ciudadanía
"CE": Cédula de Extranjería
"PA": Pasaporte
"TI": Tarjeta de Identidad
"NUIP": Número Único de Identificación Personal
"NIT": Número de Identificación Tributaria

Available options:

CC,

CE,

PA,

TI,

NUIP,

NIT

labels.description

string

Description of the signer

Maximum length: 255

labels.identification

string

Identification of the signer. Alphanumeric characters.

Maximum length: 18

labels.name

string

Legal entity name. Only for BUSINESS type.

Maximum length: 140

labels.firstName

string

First name of the signer. Only for PERSON type.

Maximum length: 140

labels.secondName

string

Optional second name of the signer. Only for PERSON type.

Maximum length: 140

labels.lastName

string

Last name of the signer. Only for PERSON type.

Maximum length: 140

labels.secondLastName

string

Optional second last name of the signer. Only for PERSON type.

Maximum length: 140

labels.countryOfResidence

string

ISO code of the country of residence of the signer.

Maximum length: 2

labels.bankAccountType

enum<string>

Type of bank account.

"SVGS": Savings
"CACC": Checking
"DBMO": Low-amount deposits
"DORD": Ordinary deposits
"DBMI": Inclusive low-amount deposits

Available options:

SVGS,

CACC,

DBMO,

DORD,

DBMI

labels.bankAccountNumber

string

Bank account number of the signer. Only digits

Maximum length: 34

labels.bankBicfi

string

Bank BICFI code of the bank. Only digits

Maximum length: 4

labels.bankName

string

Name of the bank

Maximum length: 64

labels.bankId

string

Bank NIT

Maximum length: 9

labels.routerReference

string

Bank wallet identifier.

Maximum length: 34

labels.targetSpbviCode

enum<string>

Type of SPBVI code

'TFY': TransfiYa
'ENT': Entre cuentas
'CRB': Credibanco
'VIS': Visionamos
'SRV': Servibanca

Available options:

TFY,

ENT,

CRB,

VIS,

SRV

Response

200

application/json

Signer updated successfully

string

signer_id

string

handle

string

keeper

object[]

labels

object

error

object

Get a signer with signer handle.Resolves SPI signer

{
  "signer_id": "0195b009-a139-7ff2-adac-15e3c3ecfc88",
  "id": "0195b009-a139-7ff2-adac-15e3c3ecfc88",
  "handle": "wYe6h63CNqoLxJet5jP1WWLhGi8D11ZGij",
  "keeper": [
    {
      "public": "7ef44ee7ff1f4527ef44ee7ff1f4527ef44ee7ff1f4527ef44ee7ff1f4527ef4",
      "scheme": "ecdsa-ed25519",
      "secret": "046d541aec939b4748943e49cc1117a70966a6fc87345e6052a54f1e69ea48d5"
    }
  ],
  "labels": {
    "type": "PERSON",
    "status": "INACTIVE",
    "created": "2025-03-19T15:12:55.993-05:00",
    "updated": "2025-03-20T15:12:55.993-05:00",
    "createdBy": "mSJkneiASd",
    "aliasType": "ALPHANUM",
    "aliasValue": "@jorge",
    "proprietary": "CC",
    "identification": "1010101010",
    "firstName": "Jorge",
    "lastName": "Diaz",
    "bankId": "900123456",
    "bankAccountType": "SVGS",
    "bankAccountNumber": "4123456789",
    "routerReference": "$bancorojo",
    "targetSpbviCode": "TFY",
    "consented": "2025-03-13T20:38:07-05:00",
    "received": "2025-03-13T20:38:07.123-05:00",
    "dispatched": "2025-03-13T20:38:10.123-05:00"
  }
}

Como empezar

Guias de uso

Acerca de

APIs

Archivos de Soporte

Path Parameters

Body

Response