Envio transação STR

Envios de transações via o SPB, pelas mensagens do STR.

O horário de funcionamento para envio de mensagens STR via Global é das 08:00 às 16:00, no horário de Brasília, apenas em dias úteis.

Para fazer uma transação do tipo STR, precisa seguir os passos seguintes passos:

1

Autenticação

O cliente deve esta devidamente autenticado e com liberação de fazer este tipo de transação

2

Verificação de saldo

É importante o cliente verificar se tem saldo antes de tentar fazer transações

3

Criar escolher tipo de mensagem

O cliente deve criar a mensagem do tipo da STR que deseja realizar.

4

Envio da transação

5

Receber webhook

Após o envio o cliente irá receber webhooks de acordo com as atualizações da transação ou requerimento.

Exemplo de envio:

Enviar Mensagem STR por Tipo

post

Path parameters

strTipoanyRequired

Tipo da conta debitada.

Example: STR0008

Header parameters

Chave-IdempotenciastringRequired

Identificador único em formato uuidV4. para garantir que a requisição seja idêntica em múltiplas tentativas.

Example: a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Body

application/json

strTipoenum · enumRequired

Tipo da conta debitada.

Example: STR0008Possible values:

strMensagemone ofRequired

Conteúdo da mensagem STR, a estrutura varia de acordo com o 'strTipo'.

or

Responses

200

Sucesso

application/json

codigoMensagemstringOptional

Código da mensagem STR processada.

Example: STR0008

horarioAtualstring · date-timeOptional

Horário atual do servidor (em UTC-3, fuso horário de São Paulo).

Example: 2025-04-09T15:15:00-03:00

idempotencyKeystring · uuidOptional

Chave de idempotência utilizada na requisição.

Example: a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6

numeroControleIFstringOptional

Número de controle da Instituição Financeira.

Example: ABC1234567890

codigoIdentificadorTransferenciastring · nullableOptional

Código identificador da transferência (se aplicável).

Example: TRANSF123

endToEndstringOptional

Identificador único de ponta a ponta da transação.

Example: a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6

400

Requisição inválida

application/json

422

Erro ao processar a mensagem STR (validação ou outros erros de negócio)

500

Erro interno do servidor

post

/str/{strTipo}

HTTPcURLJavaScriptPython

POST /internal/api/v1/spb/str/{strTipo} HTTP/1.1
Host: sandbox.globalscm.app.br
Chave-Idempotencia: a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6
Content-Type: application/json
Accept: */*
Content-Length: 814

{
  "strTipo": "STR0008",
  "strMensagem": {
    "codigoMensagem": "STR0008",
    "numeroControleIF": "text",
    "ispbIFDebitada": 12345678,
    "tipoContaDebitada": "CORRENTE",
    "contaDebitada": "00000123456789",
    "tipoPessoaDebitada": "FISISCA",
    "cnpjOuCpfClienteDebitado": "12345678910",
    "nomeClienteDebitado": "Fulano de Tal da Silva",
    "ispbIfCreditada": 87654321,
    "agenciaCreditada": "0001",
    "agenciaDebitada": "0001",
    "tipoContaCreditada": "CORRENTE",
    "contaCreditada": "00000987654321",
    "tipoPessoaCreditada": "FISISCA",
    "cnpjOuCpfClienteCreditado": "09876543210",
    "nomeClienteCreditado": "João da Silva Sauro",
    "valorLancamento": 12.34,
    "finalidadeCliente": "PAGAMENTO_DE_SALARIOS",
    "codigoIdentificadorTransferencia": "text",
    "historico": "text",
    "dataAgendamento": "2026-03-11",
    "horaAgendamento": "text",
    "nivelPreferencia": "PRIORIDADE_ALTA",
    "dataMovimento": "2026-03-11"
  }
}

{
  "codigoMensagem": "STR0008",
  "horarioAtual": "2025-04-09T15:15:00-03:00",
  "idempotencyKey": "a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6",
  "numeroControleIF": "ABC1234567890",
  "codigoIdentificadorTransferencia": "TRANSF123",
  "endToEnd": "a1b2c3d4-e5f6-4789-8a0b-c1d2e3f4a5b6"
}

Atualmente temos esses tipos de STR disponiveis: STR0008