> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Faça seu primeiro pagamento de teste

Aprenda como fazer seu primeiro pagamento de teste usando a API Localpayment e entenda os conceitos essenciais para executar fluxos de pagamento seguros em seu ambiente de sandbox.

Comece fazendo seu primeiro pagamento de teste com a API Localpayment no ambiente sandbox. Você autenticará suas solicitações, explorará os métodos de pagamento disponíveis, executará um pagamento com cartão, gerenciará webhooks e verificará o status final da transação.

## Visão geral

O Localpayment Sandbox é uma plataforma de testes completa que espelha nosso ambiente de produção sem processar transações reais. Ele oferece um espaço seguro para testar sua integração em diversos métodos de pagamento, moedas e países antes de entrar em produção.

> [card] [Ambiente de Sandbox](https://docs.localpayment.com/pt-br/docs/api-keys-and-environments.md)
>
> Utilize nosso endpoint de API sandbox dedicado para todas as atividades de teste.

> [card] [Dados de teste](https://docs.localpayment.com/pt-br/docs/testing.md)
>
> Acesse cartões e contas de teste abrangentes para todos os cenários.

> [card] [Simulação em tempo real](https://docs.localpayment.com/pt-br/docs/webhooks.md)
>
> Receba notificações instantâneas via webhook para todas as transações de teste.

> [card] [Referência da API](https://docs.localpayment.com/pt-br/reference/api-basics.md)
>
> Explore nossa documentação completa da API com exemplos.

***

## Antes de começar

Antes de começar, certifique-se de ter:

> [card] [Credenciais da API](https://docs.localpayment.com/pt-br/docs/api-keys-and-environments.md)
>
> Credenciais de API e token de acesso válidos para autenticação.

> [card] [Configuração da conta](https://docs.localpayment.com/pt-br/docs/make-your-first-test-payment.md)
>
> Configuração adequada da conta para o país de destino e verificação da empresa.

> [card] [Lista branca de IPs](https://docs.localpayment.com/pt-br/docs/dashboard-whitelist-your-ips.md)
>
> Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.

> [card] [Endpoint de webhook](https://docs.localpayment.com/pt-br/docs/webhooks.md)
>
> Configure um URL de webhook para receber notificações de pagamento.

***

## Passo 1: Gerar Token de Acesso

Para interagir com a API da Localpayment, você precisa de um token de acesso para autenticação. Esse token é obrigatório para todas as solicitações à API.

Para gerar um token de acesso, você precisará fazer uma solicitação `POST` ao endpoint [Gerar um token de acesso](https://docs.localpayment.com/pt-br/reference/get-token.md) com o `username` e a `password` da sua conta Localpayment incluídos no corpo da solicitação como um objeto JSON.

### Exemplo de solicitação

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/token/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "username": "{{UserName}}",
  "password": "{{password}}"
}
'
```

### Resposta bem-sucedida

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGccM5kYO7o4iOiJIU18jaiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTczNTMxOTkyOSwianRpIjoiZWUxMDE3MTUwY2JhNGM1NTg0MjYyZmRkZTdiOThiNGQiLCJ1c2VyX2lkIjoxMDAwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjp0cnVlLCJybaCIsImV4cCI62xlcyI6WyJBTEwiXSwiY291bnRyaWVzIjpbIkFMTCJdLCJjb21wYW55IjoiQUxMIiwiY2xpZW50X2NvZGUiOiJBNzaW9uTEwiLCJwZXJtaXcyI6W119.6siymomkQ72yMvHGU9sMCO4h-cxpNgQXor",
  "access": "eyJ0eXAiOiJKV1QiLCJhJIUzI1NiJ9.eyJ0b2tlbl90eXBlIbGciOijoiYWNjZXNzIiwiZXhwIjoxNzM1MjMzODI5LCJqdGkiOiJiMDRmNzQ3YWEjOCIsIn4Mjg0YjM0YmMwN2Y4ZjVkOWM0NWFVzZXJfaWQiOjEwMDAsInN1cGVydXNlciI6dHJ1ZSwiaXNfc3RhZmYiOnRy3VudHJpZXMiOljpbIkFsiQUxMIl0sImNvbXBhbnkiOiJBTEwiLCJjbGllbnRfY29kZSI6IkFMTCIsInBlcm1pc3Npb25zIjpdWUsInJvbGVzIMTCJdLlqEnH7GrECJjbbXX0.sWOLKFxCcXQkUcPvTjYceXBp39hDF3-Snc"
}
```

> [!WARNING]
>
> **Importante**
>
> Use o token `access` da resposta em todas as solicitações subsequentes à API. Inclua-o no cabeçalho `Authorization` como `Bearer <your_access_token>`. Os tokens expiram por motivos de segurança - use o [token de atualização](https://docs.localpayment.com/pt-br/reference/refresh-token.md) para obter novos tokens de acesso sem precisar se autenticar novamente.

***

## Etapa 2: Recuperar os métodos de pagamento disponíveis

Antes de criar um pagamento, verifique quais métodos de pagamento estão disponíveis para sua conta e país de destino.

Para obter os métodos de pagamento disponíveis, envie uma solicitação `GET` ao endpoint [Obter Métodos de Pagamento Disponíveis](https://docs.localpayment.com/pt-br/reference/get-available-payment-methods.md), incluindo seu `accountNumber` como parâmetro de consulta.

### Exemplo de solicitação

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request GET \
     --url 'https://api.stage.localpayment.com/api/resources/payment-methods?accountNumber=1234567890' \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json'
```

### Resposta bem-sucedida

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
[
  {
    "accountCode": "TESTARG",
    "accountNumber": "{{accountNumber}}",
    "countryISOCode3": "ARG",
    "moR": null,
    "mid": "0",
    "payinPaymentMethods": [
      {
        "id": 30,
        "code": "1005",
        "name": "Visa",
        "description": "Visa",
        "url": "https://cdn.localpayment.com/logos/visa-debit.png",
        "paymentMethodType": "DebitCard",
        "transactionType": 0,
        "country": {
          "id": 0,
          "code": "032",
          "name": "Argentina",
          "isoCode3": "ARG",
          "localCurrency": {
            "code": "032",
            "name": "Argentine peso",
            "isoCode3": "ARS",
            "decimals": 2,
            "isHard": false
          }
        }
      },
      {
        "id": 24,
        "code": "1023",
        "name": "ITAU",
        "description": "ITAU",
        "url": "https://cdn.localpayment.com/logos/itau.png",
        "paymentMethodType": "BankTransfer",
        "transactionType": 0,
        "country": {
          "id": 0,
          "code": "032",
          "name": "Argentina",
          "isoCode3": "ARG",
          "localCurrency": {
            "code": "032",
            "name": "Argentine peso",
            "isoCode3": "ARS",
            "decimals": 2,
            "isHard": false
          }
        }
      },
      {
        "id": 19,
        "code": "1000",
        "name": "Visa",
        "description": "Visa",
        "url": "https://cdn.localpayment.com/logos/visa.png",
        "paymentMethodType": "CreditCard",
        "transactionType": 0,
        "country": {
          "id": 0,
          "code": "032",
          "name": "Argentina",
          "isoCode3": "ARG",
          "localCurrency": {
            "code": "032",
            "name": "Argentine peso",
            "isoCode3": "ARS",
            "decimals": 2,
            "isHard": false
          }
        }
      },
      {
        "id": 23,
        "code": "1004",
        "name": "Santander",
        "description": "Santander",
        "url": "https://cdn.localpayment.com/logos/santander.png",
        "paymentMethodType": "BankTransfer",
        "transactionType": 0,
        "country": {
          "id": 0,
          "code": "032",
          "name": "Argentina",
          "isoCode3": "ARG",
          "localCurrency": {
            "code": "032",
            "name": "Argentine peso",
            "isoCode3": "ARS",
            "decimals": 2,
            "isHard": false
          }
        }
      },
    ],
    "payoutPaymentMethods": [
      {
        "id": 87,
        "code": "2000",
        "name": "BBVA",
        "description": "Banco Frances",
        "url": null,
        "paymentMethodType": "BankTransfer",
        "transactionType": 0,
        "country": {
          "id": 0,
          "code": "032",
          "name": "Argentina",
          "isoCode3": "ARG",
          "localCurrency": {
            "code": "032",
            "name": "Argentine peso",
            "isoCode3": "ARS",
            "decimals": 2,
            "isHard": false
          }
        }
      }
    ]
  }
]
```

> [!NOTE]
>
> Para pagamentos com cartão, procure métodos de pagamento em que `paymentMethodType` seja `CreditCard` ou `DebitCard`. Observe o valor de `code` (por exemplo, `1000` para Visa na Argentina), pois você precisará dele na solicitação de pagamento.

***

## Etapa 3: Criar uma solicitação de pagamento

Agora você está pronto para criar seu primeiro pagamento de teste. Usaremos um pagamento com cartão de crédito para a Argentina como exemplo.

Para criar um pagamento com cartão de crédito, envie uma solicitação `POST` para o endpoint [Criar Payin](https://docs.localpayment.com/pt-br/reference/payins.md), incluindo seu token `access` no cabeçalho `Authorization`.

### Campos de solicitação principais

A solicitação requer vários parâmetros-chave:

| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
| - | - | - | - | - |
| `paymentMethod.type` | string | ✅ | Tipo de método de pagamento | `CreditCard` |
| paymentMethod.code | string | ✅ | Código do método de pagamento dentre os métodos disponíveis | `1000` |
| externalId | string | ✅ | Identificador único do seu sistema (use UUID4) | `40bac59a-0381-4cc0-a6a5-33418d84c2e4` |
| country | string | ✅ | Código de país ISO 3166-1 alfa-3 | `ARG` |
| currency | string | ✅ | Código da moeda da transação | `ARS` |
| amount | number | ✅ | Valor da transação | `1000` |
| accountNumber | string | ✅ | Seu número de conta Localpayment | `{{accountNumber}}` |
| merchant | object | ✅ | Informações sobre o comerciante/empresa | Veja o objeto comerciante abaixo. |
| payer | object | ✅ | Informações do pagador/cliente | Veja o objeto pagador abaixo. |
| card | object | — | Detalhes do pagamento com cartão | Veja o objeto do cartão abaixo. |

### Exemplo de solicitação

Veja abaixo um exemplo usando `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
  --url https://api.stage.localpayment.com/api/payin/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "paymentMethod": {
    "type": "CreditCard",
    "code": "1000",
    "flow": "DIRECT"
  },
  "externalId": "{{$guid}}",
  "country": "{{country}}",
  "currency": "{{currency}}",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "conceptCode": "0001",
  "merchant": {
    "type": "COMPANY",
    "name": "Company",
    "document": {
      "type": "CUIT",
      "id": "3000091105",
    },
    "email": "mail@company.com",
    "phone": {
      "countryCode": "54",
      "areaCode": "351",
      "number": "1234567"
    }
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "type": "DNI",
      "id": "37993123"
    },
    "email": "john.doe@example.com",
    "phone": {
      "countryCode": "1",
      "areaCode": "11",
      "number": "98189123"
    },
    "bank": {
      "name": "BANCO BBVA ARGENTINA S.A.",
      "code": "017",
      "account": {
        "type": "S",
        "number": "19101196551119123456789"
      }
    }
  },
  "commercialData": {
    "items": [
      "id": "12345",
      "quantity": "1",
      "description": "Test product",
      "title": "Test",
      "unitPrice": "1000"
    ]
  },
  "card": {
    "name": "John Doe",
    "number": "4000000000000002",
    "cvv": "123",
    "expirationMonth": "12",
    "expirationYear": "2029"
  }
}'
```

### Resposta bem-sucedida

Uma resposta bem-sucedida inclui informações detalhadas sobre a transação e identificadores de rastreamento:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "40bac59a-0381-4cc0-a6a5-33418d84c2e4",
  "internalId": "22b29c98-92af-44bd-a164-1863ae2f1bb3",
  "paymentMethod": {
    "type": "CreditCard",
    "code": "1000",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "amount": 1000,
    "fxQuote": 1,
    "exchangeRateToken": null
  },
  "payment": {
    "installment": null,
    "currency": "ARS",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 1000
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "fxSource": 210.8,
    "fxQuote": 1,
    "amount": 13.02,
    "account": "{{accountNumber}}"
  },
  "status": {
    "code": "103",
    "description": "APPROVED",
    "detail": "The payin was confirmed but not credited yet"
  },
  "ticket": null,
  "qr": null,
  "beneficiary": null,
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "id": "37895247",
      "type": "DNI"
    },
    "email": "john.doe@example.com",
    "phone": {
      "countryCode": "1",
      "areaCode": "11",
      "number": "98789632"
    },
    "address": null,
    "birthdate": null,
    "nationality": null
  },
  "intermediaries": [],
  "wireInstructions": null,
  "date": {
    "creationDate": "2024-05-19T19:02:44.018+00:00",
    "processedDate": "2024-05-19T19:02:44.799618",
    "expirationDate": "0001-01-01T00:00:00"
  },
  "card": {
    "bin": "402670",
    "brand": "VISA",
    "country": "RS",
    "name": "John Doe",
    "last4": "3263",
    "expirationYear": 2029,
    "expirationMonth": 9
  },
  "errors": []
}
```

### Campos de resposta principais

| Parâmetro | Descrição | Caso de uso |
| - | - | - |
| transactionType | Tipo de transação processada | Confirme se esta é a opção "PayIn" para solicitações de pagamento. |
| externalId | Seu número de referência original | Conciliação interna e correspondência de pedidos |
| internalId | Identificador de transação exclusivo da Localpayment | Referência para suporte e consulta de transações |
| `paymentMethod.type` | Método de pagamento utilizado | Verifique se o método de pagamento está correto. |
| paymentMethod.code | Código do método de pagamento | Confirme o método de pagamento esperado. |
| `status.code` | Estado atual da transação | Determine as próximas etapas no fluxo de pagamento. |
| `status.description` | Descrição do status | Exibir mensagens de status fáceis de usar |
| `status.detail` | Informações detalhadas sobre o status | Forneça contexto específico sobre o estado da transação. |
| amount | Valor original da transação | Verifique se o valor esperado foi processado. |
| `date.creationDate` | Quando a transação foi criada | Análises e monitoramento de desempenho |
| errors | Conjunto de detalhes do erro | Gerencie e exiba quaisquer erros de transação. |

***

## Etapa 4: Lidar com notificações de webhook

Os webhooks fornecem notificações em tempo real sobre alterações no status das transações. Configure o URL do seu webhook no Business Portal da Localpayment para receber essas notificações.

### Exemplo de payload de webhook

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "40bac59a-0381-4cc0-a6a5-33418d84c2e4",
  "internalId": "22b29c98-92af-44bd-a164-1863ae2f1bb3",
  "paymentMethod": {
    "type": "CreditCard",
    "code": "1000",
    "flow": "DIRECT"
  },
  "country": "ARG",
  "currency": "ARS",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "confirmed": {
    "currency": "ARS",
    "amount": 1000,
    "fxQuote": 1,
    "exchangeRateToken": null
  },
  "payment": {
    "installment": null,
    "currency": "ARS",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 1000
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "fxSource": 210.8,
    "fxQuote": 1,
    "amount": 13.02,
    "account": "{{accountNumber}}"
  },
  "status": {
    "code": "103",
    "description": "APPROVED",
    "detail": "The payin was confirmed but not credited yet"
  },
  "ticket": null,
  "qr": null,
  "beneficiary": null,
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "id": "37895247",
      "type": "DNI"
    },
    "email": "john.doe@example.com",
    "phone": {
      "countryCode": "1",
      "areaCode": "11",
      "number": "98789632"
    },
    "address": null,
    "birthdate": null,
    "nationality": null
  },
  "intermediaries": [],
  "wireInstructions": null,
  "date": {
    "creationDate": "2024-05-19T19:02:44.018+00:00",
    "processedDate": "2024-05-19T19:02:44.799618",
    "expirationDate": "0001-01-01T00:00:00"
  },
  "card": {
    "bin": "402670",
    "brand": "VISA",
    "country": "RS",
    "name": "John Doe",
    "last4": "3263",
    "expirationYear": 2029,
    "expirationMonth": 9
  },
  "errors": []
}
```

> [!NOTE]
>
> **Dica de implementação**:
>
> Seu endpoint de webhook deve retornar imediatamente um status `200 OK` ao receber o webhook e, em seguida, processar a notificação de forma assíncrona para evitar timeouts.

***

## Etapa 5: Rastrear o status da transação

Você pode verificar proativamente o status da transação usando o endpoint [Obter Status da Transação](https://docs.localpayment.com/pt-br/reference/get-transaction-status.md). Envie uma solicitação `GET`, substituindo `{externalId}` pelo seu identificador de transação exclusivo para obter o status da transação.

### Exemplo de solicitação

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request GET \
     --url https://api.stage.localpayment.com/api/transactions/{externalId}/status \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json'
```

### Resposta bem-sucedida

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "internalId": "22b29c98-92af-44bd-a164-1863ae2f1bb3",
  "externalId": "40bac59a-0381-4cc0-a6a5-33418d84c2e4",
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "The payin was credited"
  }
}
```

### Códigos de status comuns

| Código | Status | Descrição |
| :- | :- | :- |
| `103` | `APPROVED` | O Payin foi confirmado, mas ainda não foi creditado. |
| `200` | `Completed` | O Payin foi concluído. |
| `300` | `Rejected` | Parâmetro inválido + \[nome do parâmetro] + \[motivo]. |

> [!WARNING]
>
> **Importante**
>
> Sempre verifique o campo `status.code` para determinar o resultado da transação. Para a lista completa dos possíveis status da transação, consulte a [referência de status](https://docs.localpayment.com/pt-br/reference/transaction-status-error-codes) completa.

***

## Testando diferentes métodos de pagamento

O Localpayment oferece suporte a vários métodos de pagamento além de cartões de crédito. Cada método possui parâmetros de solicitação e estruturas de resposta específicos. Abaixo, seguem exemplos para transferências bancárias com as principais diferenças destacadas.

> [tab] Pagamentos por Transferência Bancária
>
> As transferências bancárias permitem que os clientes paguem diretamente de suas contas bancárias por meio de sistemas de pagamento locais.
>
> ### Exemplo de solicitação
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payin/ \
>      --header 'accept: application/json' \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'content-type: application/json' \
>      --data '
> {
>   "paymentMethod": {
>     "type": "BankTransfer",
>     "code": "1040",
>     "flow": "DIRECT"
>   },
>   "currency": "ARS",
>   "merchant": {
>     "type": "COMPANY",
>     "name": "Company",
>     "document": {
>       "type": "CUIT",
>       "id": "3000091105",
>     },
>     "email": "mail@company.com",
>     "phone": {
>       "countryCode": "54",
>       "areaCode": "351",
>       "number": "1234567"
>     }
>   },
>   "payer": {
>     "type": "INDIVIDUAL",
>     "name": "John",
>     "lastname": "Doe",
>     "document": {
>       "type": "DNI",
>       "id": "37993123"
>     },
>     "email": "john.doe@example.com",
>     "phone": {
>       "countryCode": "1",
>       "areaCode": "11",
>       "number": "98189123"
>     },
>     "bank": {
>       "name": "BANCO BBVA ARGENTINA S.A.",
>       "code": "017",
>       "account": {
>         "type": "S",
>         "number": "19101196551119123456789"
>       }
>     }
>   },
>   "externalId": "0fcd5d00-a734-46d9-95d7-246126989132",
>   "country": "ARG",
>   "amount": 1000,
>   "accountNumber": "{{accountNumber}}",
>   "conceptCode": "0001"
> }
> '
> ```
>
> ### Principais diferenças entre os pedidos de transferência bancária
>
> | Parâmetro | Diferença em relação aos pagamentos com cartão | Exemplo |
> | - | - | - |
> | `paymentMethod.type` | Definir para `BankTransfer` em vez de `CreditCard` | `BankTransfer` |
> | `paymentMethod.code` | Use códigos específicos para transferência bancária. | `1040` (Debin) |
> | `payer.bank` | Obrigatório - Dados bancários | Objeto bancário completo |
> | objeto de cartão | Não é necessário - Remover dados do cartão | omitido |
> | `payer.bank.account.type` | Especificação do tipo de conta | `S` (Poupança) |
>
> ### Resposta bem-sucedida
>
> ```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> {
>   "transactionType": "PayIn",
>   "externalId": "0fcd5d00-a734-46d9-95d7-246126989132",
>   "internalId": "d05dab30-485f-473d-844c-041ed5355fc4",
>   "paymentMethod": {
>     "type": "BankTransfer",
>     "code": "1040",
>     "flow": "DIRECT"
>   },
>   "country": "ARG",
>   "currency": "ARS",
>   "amount": 1000,
>   "accountNumber": "{{accountNumber}}",
>   "confirmed": {
>     "currency": "ARS",
>     "fxQuote": 1,
>     "amount": 1
>   },
>   "payment": {
>     "currency": "ARS",
>     "fxQuote": 1,
>     "financingFee": 0,
>     "amount": 1
>   },
>   "localTaxes": [],
>   "withHoldings": [],
>   "fees": {
>     "description": "Fee",
>     "currency": "ARS",
>     "fxSource": 1,
>     "fxQuote": 1,
>     "amount": 0,
>     "account": "{{accountNumber}}"
>   },
>   "status": {
>     "code": "100",
>     "description": "INPROGRESS",
>     "detail": "The payin is pending the confirmation"
>   },
>   "merchant": {
>     "type": "COMPANY",
>     "name": "Company",
>     "document": {
>       "type": "CUIT",
>       "id": "3000091105",
>     },
>     "email": "mail@company.com",
>     "phone": {
>       "countryCode": "54",
>       "areaCode": "351",
>       "number": "1234567"
>     }
>   },
>   "payer": {
>     "type": "INDIVIDUAL",
>     "name": "John",
>     "lastname": "Doe",
>     "document": {
>       "type": "DNI",
>       "id": "37993123"
>     },
>     "email": "john.doe@example.com",
>     "phone": {
>       "countryCode": "1",
>       "areaCode": "11",
>       "number": "98189123"
>     },
>     "bank": {
>       "name": "BANCO BBVA ARGENTINA S.A.",
>       "code": "017",
>       "account": {
>         "type": "S",
>         "number": "19101196551119123456789"
>       }
>     }
>   },
>   "intermediaries": [],
>   "date": {
>     "creationDate": "2025-02-16T20:04:04.993",
>     "processedDate": "2025-02-16T20:04:10.969",
>     "expirationDate": "2025-02-23T20:04:05.553"
>   },
>   "errors": [],
>   "redirectUrl": "https://web-checkout.stage.localpayment.com/redirect/L3ZlcmlmaWNhdGlvbi8wMTM5P2ludGVybmFsSWQ9MGRlNmI5MmQtYjY0Yi00YThhLThjNGEtYjczNDk3ZWRhZDQx"
> }
> ```
>
> ### Principais diferenças nas respostas para transferências bancárias
>
> | Parâmetro | Diferença em relação aos pagamentos com cartão | Descrição |
> | - | - | - |
> | `paymentMethod.type` | `BankTransfer` em vez de `CreditCard` | Confirma o método de pagamento |
> | `status.code` | Muitas vezes `100` (`INPROGRESS`) inicialmente | Transferências bancárias exigem autorização do cliente. |
> | redirectUrl | Presente - URL para autorização do cliente | Direcione o cliente para concluir o pagamento. |
> | objeto de cartão | Ausente - Nenhum dado de cartão retornado | Substituído por informações bancárias |
> | expirationDate | Presente - Janela de autorização | Tempo limitado para o cliente concluir o pagamento |

***

## Próximos passos

> [card] [Explore as opções de Payins](https://docs.localpayment.com/pt-br/docs/payins-overview.md)
>
> Descubra todos os métodos de pagamento disponíveis, incluindo cartões e APMs.

> [card] [Explore as opções de Payouts](https://docs.localpayment.com/pt-br/docs/payouts-overview.md)
>
> Saiba mais sobre como enviar pagamentos para contas bancárias e carteiras digitais.

> [card] [Descubra a cobertura do país](https://docs.localpayment.com/pt-br/docs/global-coverage.md)
>
> Verifique os métodos de pagamento disponíveis, as moedas e os requisitos específicos para cada país.

> [card] [Referência da API](https://docs.localpayment.com/pt-br/reference/api-basics.md)
>
> Acesse a documentação completa da API com endpoints, parâmetros e exemplos de código.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.