Open Banking Gateway
Somente sandbox

Banco de varejo · Vietnã

ACB ONE API

Asia Commercial Bank (Vietnã) — login com usuário/senha, perfil, saldo e transações.

Testar no sandbox
5 endpointsSandbox gratuito

Sandbox · Requisição

curl · POST /login
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/acb/login' \
  -H 'Content-Type: application/json' \
  --data '{
  "phone": "0399123456",
  "password": "sandbox123"
}'

Exemplo ilustrativo do sandbox. Nenhum provedor é contatado, SMS é enviado, valor é movimentado ou crédito é cobrado.

Referência da API

Conheça cada endpoint.

Métodos, rotas e regras vêm do mesmo catálogo usado pelo console. Abra um endpoint para ver seus campos.

Descoberta

GET
/check-user

Check whether a username exists

Somente sandbox

/api/sandbox/acb/check-user

GET check-user · Parâmetro
ParâmetroTipoRegras e envio
phoneObrigatóriostring

Parâmetro de consulta

Use uma carteira autorizada. No modo real, a identidade deve estar vinculada à sua conta do site pelo login da carteira.

  • Formato: ^0\d{9,10}$

Autenticação da carteira

POST
/login

Log in with username and password

Somente sandbox

/api/sandbox/acb/login

POST login · Parâmetro
ParâmetroTipoRegras e envio
phoneObrigatóriostring

Corpo JSON

Use uma carteira autorizada. No modo real, a identidade deve estar vinculada à sua conta do site pelo login da carteira.

  • Formato: ^0\d{9,10}$
passwordObrigatóriostring

Corpo JSON

Sensível · nunca em URLs

  • Comprimento: 1 … 128

Conta e atividade

GET
/profile

User profile

Somente sandbox

/api/sandbox/acb/profile

GET profile · Parâmetro
ParâmetroTipoRegras e envio
tokenObrigatóriostring

Enviar em X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensível · nunca em URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
GET
/balance

Account balance

Somente sandbox

/api/sandbox/acb/balance

GET balance · Parâmetro
ParâmetroTipoRegras e envio
tokenObrigatóriostring

Enviar em X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensível · nunca em URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
GET
/transaction-history

Transaction history with pagination

Somente sandbox

/api/sandbox/acb/transaction-history

GET transaction-history · Parâmetro
ParâmetroTipoRegras e envio
tokenObrigatóriostring

Enviar em X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensível · nunca em URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
pageNumObrigatóriointeger

Parâmetro de consulta

  • Intervalo: 1 … 1000
pageSizeObrigatóriointeger

Parâmetro de consulta

  • Intervalo: 1 … 100

Identificadores e descrições específicas do provedor são mantidos em inglês para corresponder ao contrato.

Testar no sandbox

Uma requisição que você pode examinar.

O console inicia no sandbox. Use apenas os valores públicos de teste. Mudar para Real altera o destino e pode usar contas e fundos reais.

Sandbox

Separe testes, acesso às contas e cobrança.

Da primeira requisição à conexão real.

  1. Explore sem fazer login

    Escolha uma API e use os valores de teste documentados. As simulações não movem dinheiro nem contatam bancos.

  2. Crie sua conta na plataforma

    Entre com Google, receba 1.000 créditos e crie uma chave API. Isso conecta você ao site, não a uma carteira.

  3. Conecte quando estiver pronto

    Nas APIs com acesso real, faça o login da carteira separadamente. Cada chamada real bem-sucedida custa um crédito; falhas não custam nada.

1.000 créditos de boas-vindas · sem cartão

Comece pequeno. Custo claro.

US$ 10 compram 10.000 créditos. Uma chamada real bem-sucedida usa um; falhas e sandbox não usam créditos. Comprar créditos não libera integrações somente sandbox.

Comprar 10.000 créditos

Guia de integração

Leve para o seu código.

Exemplos de sandbox usam valores públicos. Exemplos reais usam marcadores: mantenha credenciais no servidor e nunca as inclua no repositório.

Sandbox

curl · POST
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/acb/login' \
  -H 'Content-Type: application/json' \
  --data '{
  "phone": "0399123456",
  "password": "sandbox123"
}'

Somente sandbox

Acesso ao vivo não habilitado

Fale conosco para liberar o acesso

As chamadas ao vivo para ACB ONE são liberadas por cliente. O modo Sandbox continua gratuito e não exige login.

Fale com a gente no TelegramPágina de contato

Limites claros antes da primeira requisição.

Algumas coisas que vale saber.

O sandbox usa contas reais?

Não. Usa respostas simuladas e credenciais públicas de teste. Não contata provedores financeiros, envia códigos OTP nem movimenta fundos.

Todas as APIs permitem chamadas reais?

Não. Apenas as integrações marcadas com acesso real têm um provedor conectado. As demais são somente sandbox e retornam LIVE_ACCESS_NOT_ENABLED no modo real. Fale conosco sobre o acesso.

Quando um crédito é cobrado?

Um crédito é cobrado por chamada real bem-sucedida. Falhas e sandbox são gratuitos. Consulte X-Credits-Charged, não apenas o status HTTP. Se houver X-OBG-Settlement: unknown, a cobrança está indefinida: X-Credits-Charged: 0 não comprova que nenhum crédito foi debitado. Consulte o histórico de uso e concilie antes de tentar novamente.

Entrar com Google conecta minha carteira?

Não. O Google gerencia sua conta do site, créditos e chaves API. O login da carteira é um fluxo separado para uma integração compatível e uma conta que você tenha autorização para usar.

Continue explorando.