Transferências entre contas

Operações de transferências entre contas digitais

A rota da API para sandbox é: https://apigw-sandbox.zoop.ws/v2

post
Criação de transferência interna entre contas

https://api-beta.zoop.ws/v2/marketplaces/:marketplace_id/accounts/:account_id/p2p_transfers
Este serviço permite a criação de uma operação de transferência interna entre contas digitais de um mesmo marketplace.
Request
Response
Request
Path Parameters
account_id
required
string
ID da conta de origem a ser debitada pela transferência
marketplace_id
required
string
ID do marketplace
Headers
Content-Type
required
string
application/json
Body Parameters
to
required
string
ID da conta de destino a ser creditada pela transferência
amount
required
integer
Valor em centavos a ser transferido
description
optional
string
Descrição da transferência
statement_descriptor
optional
string
Descrição a ser exibida no extrato de lançamentos das contas
reference_id
optional
string
Valor de referência da transferência no seu sistema
metadata
optional
object
Metadados associados a transferência, no formato objeto "chave": "valor"
Response
200: OK
Cake successfully retrieved.
{
"id": "dec5d520469e4671af046b45505db059", # ID da transfer
"resource": "p2p_transfer", # fixo
"type": "transfer", # tipo fixo para transfer p2p
"status": "succeeded", # status aprovado
"confirmed": "1", # flag fixo
"recipient": "2c42a9b1dea541b5a12aacd32b0fdb4d", # ID do HOLDER recebedor
"sender": "800bcd574b7743078dedb5e2c9414ae7", # ID do HOLDER pagador
"amount": "0.01", # valor da transferência
"fee": "0.00", # valor reservado para aplicação da tarifa quando existir
"net_amount": "0.01", # valor liquido da transferência descontada a tarifa formatado
"currency": "BRL", # moeda
"description": "use com moderacao", # descrição da transferência
"statement_descriptor": null, # descrição da transferência no extrato das contas
"bank_account": null, # Null para transfer p2p
"transfer_date": "2019-08-14T18:25:22+00:00", # data programada de liquidação da transferência
"created_at": "2019-08-14T18:25:22+00:00",
"updated_at": "2019-08-14T18:25:22+00:00",
"metadata": {}
"from": { # dados da autorização de debito no pagador
"id": "b9602ec221a64f8897eb883eed72592e",
"account": {
"id": "cb2a0ed4ead9473c9b304d560ab83107",
"holder": "b8c7cce7618e41618170cf45948b7af0",
"balance": "1.06",
"currency": "BRL",
"routing_number": "001",
"number": "72925596",
"status": "active",
"metadata": {},
"created_at": "2019-08-14T17:29:25.541072",
"updated_at": "2019-08-15T15:04:29.737167",
"primary": true,
"resource": "payment_account"
},
"amount": "-0.13",
"gross_amount": "-0.13",
"nsu": 11,
"date": "2019-08-15T15:04:29.848403",
"fee": "0.00",
"current_balance": "1.06",
"object_type": "transfer",
"object_id": "442b0729ff874c0d84deb905dbb18745",
"type": "transfer",
"created_at": "2019-08-15T15:04:29.729921",
"dflag": "active",
"authorization": {
"external_key": "2ed672d431054261913d0e16daf6024a",
"type": "transfer",
"status": "active"
},
"transfer": {
"id": "b9602ec221a64f8897eb883eed72592e",
"authorization_code": "ec68f18543aa45a3b88aaddbb6be616e"
},
"resource": "payment_account.entry"
},
"to": { # dados da autorização de credito no recebedor
"id": "e513ba702e2648c9b8fb5772c028ff90",
"account": {
"id": "e3f9764e9cef451a8348e489d26e80c3",
"holder": "e3f9764e9cef451a8348e489d26e80ca"
},
"amount": "0.13",
"gross_amount": "0.13",
"nsu": 9,
"date": "2019-08-15T15:04:29.848451",
"fee": "0.00",
"current_balance": "2.04",
"object_type": "transfer",
"object_id": "b4137edf22724c1bbb902e0e40669260",
"type": "transfer",
"created_at": "2019-08-15T15:04:29.729974",
"dflag": "active",
"authorization": {
"external_key": "2ed672d431054261913d0e16daf6024a",
"type": "transfer",
"status": "active"
},
"transfer": {
"id": "e513ba702e2648c9b8fb5772c028ff90",
"authorization_code": "ec68f18543aa45a3b88aaddbb6be616e"
},
"resource": "payment_account.entry"
}
}
402: Payment Required
Erro em caso de falta de saldo na conta de origem a ser debitada pela transferência.
{
"status": "payment_required",
"type": "invalid_state",
"message": "Insufficient funds",
"category": "business",
"status_code": 402
}

get
Listagem de transferências entre contas

https://api-beta.zoop.ws/v2/marketplaces/:marketplace_id/accounts/:account_id/p2p_transfers
Serviço que lista de maneira paginada transferências entre contas digitais do mesmo marketplace
Request
Response
Request
Path Parameters
account_id
required
string
ID da conta origem das transferências enviadas
marketplace_id
required
string
ID do marketplace
Response
200: OK

get
Recuperar detalhes de uma transferência entre contas

https://api-beta.zoop.ws/v2/marketplaces/:marketplace_id/accounts/:account_id/p2p_transfers/:p2p_transfer_id
Serviço que recupera os detalhes de uma transferência entre contas
Request
Response
Request
Path Parameters
p2p_transfer_id
required
string
ID da transferência entre contas
account_id
required
string
ID da conta de origem da transferência enviada
marketplace_id
required
string
ID do marketplace
Response
200: OK