Cadastro de cartão de crédito/débito - Histórico de revisão

Felipe: Criou página com 'O objetivo deste serviço é realizar a inclusão de um cartão de crédito/débito para um cliente ou mercado. Abaixo, segue exemplo do json de envio:
2021-06-04T12:01:47Z

Criou página com 'O objetivo deste serviço é realizar a inclusão de um cartão de crédito/débito para um cliente ou mercado. Abaixo, segue exemplo do json de envio: <syntaxhighlight lang=...'

Página nova
O objetivo deste serviço é realizar a inclusão de um cartão de crédito/débito para um cliente ou mercado. Abaixo, segue exemplo do json de envio:

<syntaxhighlight lang="json" line="1">
{
"payment_card_insert":
{
"person":
{
"type": "customer",
"id": 15
},
"card":
{
"number": "6548654825149256",
"holder": "Jose Bonifacio da Silva",
"expiration_date": "12/2020",
"brand": "visa",
"type": "credit",
"default": true,
"generate_token": true,
"security_code": "2545"
}
}
}
</syntaxhighlight>

'''Detalhamento dos campos'''
<table style="border-collapse: collapse; width: 100%;" border="1">
<tr style="height: 18px;">
<td style="width: 2.56232%; height: 18px;"><strong>ID</strong></td>
<td style="width: 6.5821%; height: 18px;"><strong>Campo</strong></td>
<td style="width: 3.62012%; height: 18px;"><strong>Obrigatório</strong></td>
<td style="width: 1.04384%; height: 18px;"><strong>Pai</strong></td>
<td style="width: 0.754148%; height: 18px;"><strong>Tipo</strong></td>
<td style="width: 38.7146%; height: 18px;"><strong>Observações</strong></td>
</tr>
<tr style="height: 18px;">
<td style="width: 2.56232%; height: 18px;">A01</td>
<td style="width: 6.5821%; height: 18px;">payment_card_insert</td>
<td style="width: 3.62012%; height: 18px;">Sim</td>
<td style="width: 1.04384%; height: 18px;">Raiz</td>
<td style="width: 0.754148%; height: 18px;">-</td>
<td style="width: 38.7146%; height: 18px;"> </td>
</tr>
<tr style="height: 18px;">
<td style="width: 2.56232%; height: 10px;">A02</td>
<td style="width: 6.5821%; height: 10px;">person</td>
<td style="width: 3.62012%; height: 10px;">Sim</td>
<td style="width: 1.04384%; height: 10px;">A01</td>
<td style="width: 0.754148%; height: 10px;">-</td>
<td style="width: 38.7146%; height: 10px;">
<p>Grupo de informações da pessoa</p>
</td>
</tr>
<tr style="height: 18px;">
<td style="width: 2.56232%; height: 10px;">B01</td>
<td style="width: 6.5821%; height: 10px;">type</td>
<td style="width: 3.62012%; height: 10px;">Sim</td>
<td style="width: 1.04384%; height: 10px;">A02</td>
<td style="width: 0.754148%; height: 10px;">Texto</td>
<td style="width: 38.7146%; height: 10px;">
<p>Define o alvo, podendo ser:</p>
<ul>
<li><strong>customer</strong>: cliente</li>
<li><strong>prospect</strong>: mercado</li>
</ul>
</td>
</tr>
<tr style="height: 18px;">
<td style="width: 2.56232%; height: 10px;">B02</td>
<td style="width: 6.5821%; height: 10px;">id</td>
<td style="width: 3.62012%; height: 10px;">Sim</td>
<td style="width: 1.04384%; height: 10px;">A02</td>
<td style="width: 0.754148%; height: 10px;">Número</td>
<td style="width: 38.7146%; height: 10px;">
<p>Código do cliente/mercado (conforme o campo anterior). Aceita valores positivos maiores que zero.</p>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 10px;">A03</td>
<td style="width: 6.5821%; height: 10px;">card</td>
<td style="width: 3.62012%; height: 10px;">Sim</td>
<td style="width: 1.04384%; height: 10px;">A01</td>
<td style="width: 0.754148%; height: 10px;">-</td>
<td style="width: 38.7146%; height: 10px;">
<p>Grupo de informações do cartão.</p>
</td>
</tr>
<tr style="height: 62px;">
<td style="width: 2.56232%; height: 46px;">C01</td>
<td style="width: 6.5821%; height: 46px;">number</td>
<td style="width: 3.62012%; height: 46px;">Sim</td>
<td style="width: 1.04384%; height: 46px;">A03</td>
<td style="width: 0.754148%; height: 46px;">Texto</td>
<td style="width: 38.7146%; height: 46px;">
<p>Número do cartão sem pontuação. Aceita números entre 13 e 19 dígitos.</p>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 23px;">C02</td>
<td style="width: 6.5821%; height: 23px;">holder</td>
<td style="width: 3.62012%; height: 23px;">Sim</td>
<td style="width: 1.04384%; height: 23px;">A03</td>
<td style="width: 0.754148%; height: 23px;">Texto</td>
<td style="width: 38.7146%; height: 23px;">
<p>Nome do portador do cartão. Aceita no máximo 30 dígitos. Informar sem caracteres especiais ou acentuações.</p>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 23px;">C03</td>
<td style="width: 6.5821%; height: 23px;">expiration_date</td>
<td style="width: 3.62012%; height: 23px;">Sim</td>
<td style="width: 1.04384%; height: 23px;">A03</td>
<td style="width: 0.754148%; height: 23px;">Data</td>
<td style="width: 38.7146%; height: 23px;">
<p>Data de expiração do cartão no formato MM/AAAA. Aceita períodos maiores ou iguais à data atual.</p>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 23px;">C04</td>
<td style="width: 6.5821%; height: 23px;">brand</td>
<td style="width: 3.62012%; height: 23px;">Sim</td>
<td style="width: 1.04384%; height: 23px;">A03</td>
<td style="width: 0.754148%; height: 23px;">Texto</td>
<td style="width: 38.7146%; height: 23px;">
<p>Bandeira do cartão. Valores válidos (até 08/2020 para Administradora de cartões Cielo):</p>
<ul>
<li><strong>amex</strong>: American Express</li>
<li><strong>diners</strong>: Diners</li>
<li><strong>elo</strong>: Elo</li>
<li><strong>hipercard</strong>: Hipercard</li>
<li><strong>jcb</strong>: JCB</li>
<li><strong>master</strong>: MasterCard</li>
<li><strong>discover</strong>: Discover</li>
<li><strong>aura</strong>: Aura</li>
<li><strong>visa</strong>: Visa</li>
</ul>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 23px;">C05</td>
<td style="width: 6.5821%; height: 23px;">type</td>
<td style="width: 3.62012%; height: 23px;">Sim</td>
<td style="width: 1.04384%; height: 23px;">A03</td>
<td style="width: 0.754148%; height: 23px;">Texto</td>
<td style="width: 38.7146%; height: 23px;">
<p>Tipo do cartão. Valores válidos:</p>
<ul>
<li><strong>credit</strong>: cartão de crédito</li>
<li><strong>debit</strong>: cartão de débito</li>
<li><strong>multiple</strong>: múltiplo (crédito e débito)</li>
</ul>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 23px;">C06</td>
<td style="width: 6.5821%; height: 23px;">default</td>
<td style="width: 3.62012%; height: 23px;">Não</td>
<td style="width: 1.04384%; height: 23px;">A03</td>
<td style="width: 0.754148%; height: 23px;">Booleano</td>
<td style="width: 38.7146%; height: 23px;">
<p>Define se o cartão informado será definido como o cartão padrão do cliente utilizado para cobranças recorrentes. Atenção: requer um cartão com a função <strong>débito</strong>. Valores permitidos:</p>
<ul>
<li><strong>true</strong>: define o cartão como padrão.</li>
<li><strong>false</strong>: não define o cartão como padrão.</li>
</ul>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 10px;">C07</td>
<td style="width: 6.5821%; height: 10px;">generate_token</td>
<td style="width: 3.62012%; height: 10px;">Não</td>
<td style="width: 1.04384%; height: 10px;">A03</td>
<td style="width: 0.754148%; height: 10px;">Booleano</td>
<td style="width: 38.7146%; height: 10px;">
<p>Define se deverá ser gerado o token do cartão para cobranças periódicas. Valores permitidos:</p>
<ul>
<li><strong>true</strong>: gera token do cartão.</li>
<li><strong>false</strong>: não gera token do cartão.</li>
</ul>
</td>
</tr>
<tr style="height: 94px;">
<td style="width: 2.56232%; height: 10px;">C08</td>
<td style="width: 6.5821%; height: 10px;">security_code</td>
<td style="width: 3.62012%; height: 10px;">Não*</td>
<td style="width: 1.04384%; height: 10px;">A03</td>
<td style="width: 0.754148%; height: 10px;">Texto</td>
<td style="width: 38.7146%; height: 10px;">
<p>Código de segurança do cartão. Este campo aceita apenas números. Este campo é obrigatório se o campo generate_token foi definido como <strong>true</strong>.</p>
</td>
</tr>
</table>
<p> </p>
'''Mensagem de retorno'''

Em caso de sucesso, será retornado um json conforme o exemplo abaixo:

<syntaxhighlight lang="json" line="1">
{
"status": 1,
"error_code": 0,
"error_description": "",
"result":
{
"card_id": 22,
"generated_token": true
}
}
</syntaxhighlight>

Em caso de falha, será retornado um json conforme o exemplo abaixo:

<syntaxhighlight lang="json" line="1">
{
"status": 0,
"error_code": 19,
"error_description": "Unknown error!",
"result": ""
}
</syntaxhighlight>