Desenvolvedor de sinal do OneSpan: substituir a assinatura do remetente da conta

No blog anterior " Carregar assinatura para seu assinante ”, Exploramos como a assinatura capturada funciona no OneSpan Sign e como fazer upload de uma assinatura para seus assinantes se o aplicativo estiver integrado e usando uma assinatura personalizada de um bloco de assinaturas. Hoje, aprofundaremos e discutiremos dois cenários de exceção que você pode encontrar ao fazer upload de uma assinatura para remetentes aos quais você não tem acesso e não é possível modificar a assinatura do perfil de remetente.

Substituir assinatura do remetente da conta

Ao criar um pacote com a assinatura do assinante carregada, você adicionaria um valor desenhado à mão no bloco "signature" na carga útil da sua solicitação diretamente. No entanto, essa prática funciona apenas para os assinantes cujo email não foi registrado como uma conta no OneSpan Sign. Se você fizer o mesmo com um remetente da conta, o OneSpan Sign reconhecerá o remetente e ignorará sua assinatura carregada. Para obter uma substituição da assinatura registrada de um remetente, você precisará executar algumas etapas extras. Este blog mostrará os detalhes desse processo.

1 Crie seu pacote e deixe o status como "DRAFT".

2) Atualize a assinatura do seu assinante

Primeiro, chame a API " GET / api / packages / {packageID} / functions / {roleID} ”Para pegar o JSON da função inteira. 

Em seguida, substitua o valor desenhado à mão pela nova assinatura.

Em seguida, chame " PUT / api / packages / {packageID} / functions / {roleID} ”Para permitir que a alteração entre em vigor.

3) Envie seu pacote.
Na primeira vez em que você cria um assinante, o OneSpan Sign reconhece o remetente e injeta automaticamente as informações relacionadas à função. Essas informações de função incluem a assinatura desenhada à mão. Com essa assinatura já anexada ao assinante, o OneSpan Sign ignora sua assinatura carregada e o padrão é a assinatura que ela já possui no arquivo. Através dessas três etapas mencionadas acima, você atualiza o assinante manualmente e o OneSpan Sign não corresponde novamente ao assinante. Portanto, a modificação é válida.

Nota:

• Na verdade, esse processo não modifica a assinatura original e só funciona dessa vez. 
• Ele pode substituir a assinatura de qualquer conta, incluindo sua própria conta.

Carregar assinatura para um notário

Embora o processo acima funcione na maioria das situações, há etapas especiais que você deve executar para enviar uma assinatura quando um notário existir. 

Passo 1

Crie um pacote autenticado sem atribuir o notaryRoleID e deixe-o no status "DRAFT". Com a API, substitua as informações da função de notário pelas suas: 

POST / api / packages
Autorização: Apikey básico
Accept: application / json
Tipo de conteúdo: multipart / form-data
Solicitar carga útil:
{
   "papéis": [
      {
         "id": "role1",
         "type": "SIGNER",
         "index": 0,
         "signatários": [
            {
               "email": "seu notário email",
               "firstName": "notary.firstname",
               "lastName": "notary.lastname"
            }
         ],
         "name": "Signer1"
      }
      {
         "id": "role2",
         "type": "SIGNER",
         "index": 0,
         "signatários": [
            {
               "id": "role2",
               "email": "signer1 @mailinator .com ",
               "firstName": "1.firstname",
               "lastName": "1.lastname"
            }
         ],
         "name": "Signer2"
      }
   ],
   "status": "DRAFT",
   "documentos": [
      ......
   ],
   "notarizado": verdadeiro,
   "notaryRoleId": null,
   "type": "PACOTE",
   "name": "teste de assinatura de upload para notário"
}

Passo 2

Assinatura de atualização para notário:
(1) Usar GET / api / packages / {packageID} / functions / {notaryRoleID} e copie todo o corpo da resposta
(2) Atualizar notário:

PUT / api / packages / {packageID} / functions / {notaryRoleID}
Autorização: Apikey básico
Accept: application / json
Tipo de conteúdo: application / json
Solicitar carga útil:
{
   ...
    "signatários": [
        {
          ...
            "signature": {
                "textual": nulo,
                "handdrawn": "seu valor handdrawn"
              }
          ...
        }
],
”Name”: ”Signer1”
}

Você colará o corpo da resposta na sua carga e substituirá o valor desenhado à mão pelo seu.

Etapa 3

Atribua notaryRoleID no nível do pacote:

PUT / api / packages / {packageID}
Autorização: Apikey básico
Accept: application / json
Tipo de conteúdo: application / json
Solicitar carga útil:
{
    "notaryRoleId": "seu ID de notário"
}

Passo 4

Envie o pacote:

PUT / api / packages / {packageID}
Autorização: Apikey básico
Accept: application / json
Tipo de conteúdo: application / json
Solicitar carga útil:
{
    "status": "SENT"
}

Nota:

• As etapas 3 e 4 devem ser realizadas por meio de duas chamadas de API separadas.

O ponto principal por trás dessas quatro etapas é que, se você seguir o processo que fizemos na primeira seção, você receberá um erro dizendo "você não pode editar um notário". Mas, se você não atribuir um notário até atualizar seu valor desenhado à mão, poderá evitar esse erro e tudo funcionará conforme o esperado. 

Se você tiver acesso a seus remetentes e notários, ainda é melhor atualizar sua assinatura de perfil de remetente, e é sempre recomendável testar todo o processo no Postman antes de implementá-lo no código. 

Se você tiver alguma dúvida sobre este blog ou qualquer outra coisa relacionada à integração do OneSpan Sign ao seu aplicativo, visite o Fóruns da comunidade de desenvolvedores . Seu feedback é importante para nós!