Validação de recebimento de PIX

Para receber um pagamento via Pix Cash-in na GlobalSCM, os clientes indiretos devem fazer a validação dos seus clientes para receber um PIX. Em caso de não aceite do PIX, o código de rejeição deve ser respondido corretamente conforme descrito.

O tempo limite para devolver uma resposta dessa requisição é de 5 segundos.

Cada cliente indireto deve fornecer uma URL para que consigamos enviar os dados para que ele valide a conta recebedora.

Validar recebimento de transação. o URL a ser usado deve ser o da empresa que vai receber

post

Endpoint para validar uma transação de recebimento ou devolução.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

tpIniciacaointeger · enumRequired

Tipo de mecanismo utilizado para iniciação do pagamento.

Example: 3Possible values:

prioridadePagamentointeger · enumRequired

Indica se a liquidação é prioritária ou não.

Example: 0Possible values:

tpPrioridadePagamentointeger · enumRequired

Indica o tipo da transação prioritária ou não.

Example: 0Possible values:

finalidadeinteger · enumRequired

Finalidade da transação.

Example: 1Possible values:

modalidadeAgenteinteger · enumRequired

Modalidade do agente de saque.

Example: 1Possible values:

ispbPssintegerRequired

ISPB do facilitador de serviço de saque (PSS).

Example: 12345678

cnpjIniciadorPagamentointegerRequired

CNPJ da instituição iniciadora do pagamento.

Example: 12345678000123

dtHrOpstring · date-timeRequired

Momento em que a Ordem de Pagamento foi informada.

Example: 2020-01-23T22:08:10.012Z

valornumber · floatRequired

Valor da Transação.

Example: 150.85

infEntreClientesstringRequired

Conjunto de elementos usados para envio de informações entre Cliente Pagador e Cliente Recebedor.

Example: Compra Paga

Responses

200

Validação feita com sucesso. Pode receber a transação.

application/json

validobooleanRequired

Os dados conferem e está apto a receber transações.

Example: true

motivoRejeicaostring · enum · max: 4Optional

Obrigatorio quando for rejeitar. Motivo da Rejeição. Domínio:

Example: AC03Possible values:

detalhesstringOptional

Informações adicionais sobre o motivo da rejeição, caso aplicável.

Example: Motivo detalhado da rejeição, caso necessário.

post

/internal/api/v1/validacao

HTTPcURLJavaScriptPython

POST /internal/api/v1/validacao HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 732

{
  "tpIniciacao": 3,
  "prioridadePagamento": 0,
  "tpPrioridadePagamento": 0,
  "finalidade": 1,
  "modalidadeAgente": 1,
  "ispbPss": 12345678,
  "cnpjIniciadorPagamento": 12345678000123,
  "pagador": {
    "ispb": 4358798,
    "tpPessoa": 0,
    "cpfCnpj": 11111111111,
    "nome": "Fulano de Tal",
    "nrAgencia": "1234",
    "tpConta": 0,
    "nrConta": "12345678"
  },
  "recebedor": {
    "ispb": 4358798,
    "tpPessoa": 1,
    "cpfCnpj": 4358798000107,
    "nrAgencia": "4321",
    "tpConta": 0,
    "nrConta": "87654321"
  },
  "dtHrOp": "2020-01-23T22:08:10.012Z",
  "valor": 150.85,
  "vlrDetalhe": [
    {
      "vlrTarifaDinheiroCompra": 50.5,
      "tipo": 1
    }
  ],
  "infEntreClientes": "Compra Paga",
  "creditoOrdemPagamento": {
    "endToEndId": "E0435879820200123221500000000001",
    "idConciliacaoRecebedor": "REC00000000000000000000000000000001",
    "chave": "[email protected]"
  }
}

200

Validação feita com sucesso. Pode receber a transação.

{
  "valido": true,
  "motivoRejeicao": "AC03",
  "detalhes": "Motivo detalhado da rejeição, caso necessário."
}

Evento: pix_in

Verificar a documentação do Webhook.