Realizar um Pix por Chaves Pix

Importante:

Para usar esta API, é necessário estar autenticado e incluir seu token de autenticação no cabeçalho da requisição. Consulte a documentação de Autenticação na plataforma para mais informações.

Autenticação.

A funcionalidade de pagamentos e transferências via Pix oferece aos clientes da GlobalSCM a capacidade de realizar transações financeiras de forma rápida, segura e conveniente utilizando chaves Pix.

Um cliente da GlobalSCM deseja transferir fundos para um amigo utilizando o Pix. Para isso, ele seleciona a chave Pix do amigo (número de telefone celular) como destinatário da transação, informa o valor a ser transferido e confirma a transação. Em segundos, os fundos são transferidos para a conta do amigo, proporcionando uma experiência de pagamento rápida e sem complicações.

A funcionalidade de pagamentos e transferências via Pix da GlobalSCM oferece aos clientes uma maneira conveniente e eficiente de realizar transações financeiras, proporcionando maior flexibilidade e agilidade nas operações bancárias do dia a dia.

Como utilizar?

Para utilizar essa funcionalidade, siga estes passos simples. Abaixo, você encontrará exemplos de como realizar o processo de abertura de conta.

Realizar um Pix por Chaves Pix

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

Chave-IdempotenciastringRequired

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

Example: 123e4567-e89b-12d3-a456-426614174000

Body

application/json

amountstringRequiredExample: 0.01

initializationTypestringRequiredExample: DICT

transacionalTypestringRequiredExample: TRANSFER

urgencystringRequiredExample: HIGH

Responses

201

successful

application/json

401

authorization failed

422

validation failed

500

unknown server error

post

https://sandbox.globalscm.app.br/internal/api/v1/payments

HTTPcURLJavaScriptPython

POST https://sandbox.globalscm.app.br/internal/api/v1/payments HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Chave-Idempotencia: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 471

{
  "amount": 0.01,
  "initializationType": "DICT",
  "payer": {
    "accountNumber": "2",
    "accountType": "CORRENTE",
    "agencyNumber": "1",
    "cpfCnpj": 41014420000104,
    "ispb": 11165756,
    "name": "REVIVE CARE DESCARTAVEIS HOPITALARES DO BRASIL LTDA",
    "personType": "JURIDICA"
  },
  "receiver": {
    "accountNumber": "1",
    "accountType": "CORRENTE",
    "agencyNumber": "1",
    "cpfCnpj": 12560480034,
    "ispb": 20757199,
    "name": "PAY4FUN IP S.A.",
    "personType": "FISICA",
    "key": "12560480034"
  },
  "transactionType": "TRANSFER",
  "urgency": "HIGH"
}

{
  "idempotencyKey": "167efd4b-46b9-4208-ac1d-4e603903aaf0",
  "endToEnd": "E18236120202412231857s06fxxxxe23F",
  "message": "PROCESSING",
  "createdAt": "2025-12-23T15:30:00.000Z"
}

Requisição de exemplo

JSON Retorno Sucesso

{
    "idepotencyKey": "f6a797ab-6d5c-47dc-bf3c-b1d2d9852075",
    "endToEndId": "E3015394320240302181746720298742",
    "message": "PROCESSING",
    "createdAt": "2024-03-02T15:17:46"
}