Deposit api - aegonplatform/gateway-pub-sample GitHub Wiki
<< Web Service API | API de saque >>
Disponibiliza métodos para manipulação de dados referentes a depósitos.
Endpoint | Método | Descrição |
---|---|---|
/deposits/getnewaddress | GET | Solicita novo endereço |
/deposits/gettransaction/{txid} | GET | Retorna dados de uma transação por ID |
/deposits/gettransactionbyaddress/{address} | GET | Retorna dados de uma transação por endereço |
/deposits/aegonpurchaseorder | GET | Solicita novo endereço de depósito para adquirir créditos AEGON (AEGON Cash) |
Veja alguns classes para seu projeto e exemplos de código em sua linguagem de programação.
Solicita novo endereço para depósito.
Resource URL
/deposits/getnewaddress
Available Version
Todas
HTTP Methods
GET
Parâmetros
Nome | Tipo | Descrição | Mandatório |
---|---|---|---|
ticker | string | Ticker da Moeda, ex: BTC | Sim |
string | Email da pessoa que está solicitando endereço | Sim | |
fromMaster | string | Buscar novo endereco da conta master do Gateway | Nao |
customer | json/string | Informações detalhadas do cliente | Nao |
referenceId | string | ID de referência da aplicação cliente | Nao |
Exemplo de envio
http://gateway-pub.mydomain.fun/api/deposits/getnewaddress?ticker=BTC&[email protected]&fromMaster=true&customer={"name":"Test","lang":"en", "thumbnail":"http://img.images.com/avatar.jpg","joker":{}}
Exemplo de resposta
{
"address": "mmRsBDx4yUEj4qDMNY2qvMiQ344gXZtxf4",
"destTag": "",
"expired": 1576951456097
}
Modelo de dados / Resposta
Nome | Tipo | Descrição |
---|---|---|
address | string | Endereço do ticker solicitado |
destTag | string | Flag para "Tag Destination", mercados futuros, retorno sempre vazio |
expired | string | Timestamp de expiração do endereço |
Retorna dados de uma transação por ID.
Resource URL
/deposits/gettransaction/{txid}
Available Version
Todas
HTTP Methods
GET
Parâmetros
Nome | Tipo | Descrição | Mandatório |
---|---|---|---|
txid | string | Id da transação | Sim |
Exemplo de envio
http://gateway-pub.mydomain.com/api/deposits/gettransaction/ee0e5bbb6f761f64c726cb891c28ffd5fbddf9a965c74dc671fd6ae2ed2b21b1
Exemplo de resposta
{
"ticker": "btc",
"type": "deposit",
"status": "finished",
"amount": 0.0001,
"address": "mhQXSiDjNWue5AM58qrdbBC5ZUbNLi4tYb",
"txid": "ee0e5bbb6f761f64c726cb891c28ffd5fbddf9a965c74dc671fd6ae2ed2b21b1",
"confirmations": 1,
"fee": 0,
"created": 1576519822033,
"finished": 1576520716660,
"customer": {
"email": "[email protected]",
"name": "Test",
"lang": "en",
"thumbnail": "http://img.images.com/avatar.jpg",
"joker": {}
},
"joker": {
"referenceId": "1"
}
}
Modelo de dados / Resposta
Nome | Tipo | Descricao |
---|---|---|
ticker | string | Ticker da Moeda, ex: BTC |
type | string | Identifica o tipo de transação |
status | string | Indica a situação atual do registro: **blockchain** (transação esta em blockchain e não confirmada ainda), **finished** (já confirmada e finalizada)
|
amount | string | Valor da transação na blockchain (valor depositado de fato na blockchain) |
address | string | Endereço associado a esta transação |
txid | string | ID da transação |
confirmations | string | Quantidade de confirmações na blockchain desta transação |
fee | string | Taxa da blockchain cobrada nesta transação |
created | string | Timestamp da criação da transação no gateway |
finished | string | Timestamp de quando a transação foi dada como finalizada no gateway |
customer | json/string | Objeto JSON com os dados do cliente associados a esta transação |
joker | string | Objeto JSON com dados extras como ID de referência da aplicação cliente |
Retorna dados de uma transação por endereço (address).
Resource URL
/deposits/gettransactionbyaddress/{address}
Available Version
Todas
HTTP Methods
GET
Parâmetros
Nome | Tipo | Descrição | Mandatório |
---|---|---|---|
address | string | Endereço que gerou a transação | Sim |
Exemplo de envio
http://gateway-pub.mydomain.com/api/deposits/gettransactionbyaddress/mhQXSiDjNWue5AM58qrdbBC5ZUbNLi4tYb
Exemplo de resposta
{
"ticker": "btc",
"type": "deposit",
"status": "finished",
"amount": 0.0001,
"address": "mhQXSiDjNWue5AM58qrdbBC5ZUbNLi4tYb",
"txid": "ee0e5bbb6f761f64c726cb891c28ffd5fbddf9a965c74dc671fd6ae2ed2b21b1",
"confirmations": 1,
"fee": 0,
"created": 1576519822033,
"finished": 1576520716660,
"customer": {
"email": "[email protected]",
"name": "Test",
"lang": "en",
"thumbnail": "http://img.images.com/avatar.jpg",
"joker": {}
},
"joker": {
"referenceId": "1"
}
}
Modelo de dados / Resposta
Nome | Tipo | Descrição |
---|---|---|
ticker | string | Ticker da Moeda, ex: BTC |
type | string | Identifica o tipo de transação |
status | string | Indica a situação atual do registro: **blockchain** (transação esta em blockchain e não confirmada ainda), **finished** (já confirmada e finalizada)
|
amount | string | Valor da transação na blockchain (valor depositado de fato na blockchain) |
address | string | Endereço associado a esta transação |
txid | string | ID da transação |
confirmations | string | Quantidade de confirmações na blockchain desta transação |
fee | string | Taxa da blockchain cobrada nesta transação |
created | string | Timestamp da criação da transação no gateway |
finished | string | Timestamp de quando a transação foi dada como finalizada no gateway |
customer | json/string | Objeto JSON com os dados do cliente associados a esta transação |
joker | string | Objeto JSON com dados extras como ID de referência da aplicação cliente |
Retorna dados para compra de créditos AEGON (AEGON Cash).
Resource URL
/deposits/aegonpurchaseorder
Available Version
Todas
HTTP Methods
GET
Parâmetros
Nome | Tipo | Descricao | Mandatorio |
---|---|---|---|
ticker | string | Ticker em qual deseja pagar pelos créditos (use BTC) | Sim |
string | Email de quem esta solicitado os créditos | Sim |
Exemplo de envio
http://gateway-pub.mydomain.com/api/deposits/aegonpurchaseorder?ticker=btc&[email protected]
Exemplo de resposta
{
"address": "moCPV6dB7Yw45t1TE3SDtjNMgiUSYaKun5",
"destTag": "",
"expired": 1577029061684,
"fee": 0.01
}
Modelo de dados / Resposta
Nome | Tipo | Descrição |
---|---|---|
address | string | Endereço BTC (ou ticker) para efetuar o depósito |
destTag | string | Flag para "Tag Destination", mercados futuros, retorno sempre vazio |
expired | string | Timestamp de expiração do endereço |
fee | string | Taxa negociada para utilização do gateway |