Transactions

You can get a user's transaction history within your application, and also get a user's available balance.

To query a user's transaction, you must provide an X-App-Wallet-Access-Token. Please, see the authentication section on how to obtain X-App-Wallet-Access-Token.

Eyowo Wallet Balance

GET https://api.console.eyowo.com/v1/users/balance

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "user": {
            "id": "XXXXXXXXX",
            "mobile": "2347012345594004",
            "balance": 100000000
        }
    }
}

App Transactions History

GET https://api.console.eyowo.com/v1/transactions

Query Parameters

Name	Type	Description
limit	number	number
pages	number	number
type	string	Enum ["bank', "phone", "bills", "bvn", "vtu"]

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
  "success": true,
  "data": {
    "transactions": [
        {
          "amount": 100000,
          "reference": "5f5791735183d4378865633",
          "type": "PHONE_TRANSFER",
          "recipient": {
            "eyowo": {
             "userID": "5f5791735183d4378865633",
              "mobile": "23499999999999"
            }
          },
          "createdAt": "2019-07-01T22:40:22.122Z",
          "updatedAt": "2019-07-01T22:40:22.122Z"
        },
        {
          "amount": 100000,
          "reference": "5f5791735183d4378865633",
          "type": "BANK_TRANSFER",
          "recipient": {
            "bank": {
             "accountNumber": "111111111",
              "accountName": "Joe Doe",
              "bankCode": "000014"
            }
          },
          "createdAt": "2019-07-01T22:40:22.122Z",
          "updatedAt": "2019-07-01T22:40:22.122Z"
        },
      ]
    }
  }
}

App Transactions History by Transaction Reference

GET https://api.console.eyowo.com/v1/transactions/:transactionRef

Path Parameters

Name	Type	Description
transactionRef	string	5d1a8..... <valid transaction ref>

Query Parameters

Name	Type	Description
limit	number	number
pages	number	number
type	string	Enum ["bank', "phone", "bills", "bvn", "vtu"]

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "transaction": {
            "amount": 100000,
            "reference": "5d1a8bd6f9be2b6a62e0d104",
            "type": "PHONE_TRANSFER",
            "recipient": {
                "eyowo": {
                    "userID": "5d0ab9145c1a81610ff4b89d",
                    "mobile": "2349095801772"
                }
            },
            "createdAt": "2019-07-01T22:40:22.122Z",
            "updatedAt": "2019-07-01T22:40:22.122Z"
        }
    }
}