Transactions

Smile's Transactions product is especially useful for organizations looking to augment their user data with alternative income sources and employment. This is especially helpful when targeting the underbanked and gig economy workers. You can use the information they share from their work in gig platforms to make better decisions regarding what services to offer them.

Coupled with our Identity product, you can match your customer's provided information against data from verifiable sources, such as government records and social security agencies.

This information can be used any number of ways:

assessing income from multiple gig platforms to verify alternative income sources
assessing work activity on gig platforms
assessing credit worthiness

Combined with our Incomes product, you can build a holistic view of your user's income level and determine appropriate financial services to offer and provide to them.

Sample Transaction Data

Transaction data is typically derived from gig platform accounts and contains information on the amount earned and the date of transactions. We also surface any existing information on the nature of the work item, where applicable.

[{
    "id": "t-123abc456def789abc123def456abc78",
    "date": "2022-08-31",
    "currency": "PHP",
    "amount": -16.9,
    "metadata": {
        "createdAt": "2022-09-02T23:36:12Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    },
    "description": "Platform fee",
    "referenceId": "Order ID-996438805066"
}, {
    "id": "t-123abc456def789abc123def456abc78",
    "date": "2022-08-29",
    "currency": "PHP",
    "amount": 550,
    "metadata": {
        "createdAt": "2022-09-02T23:36:12Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    },
    "description": "Order revenue",
    "referenceId": "Order ID-994728692055"
}, {
    "id": "t-123abc456def789abc123def456abc78",
    "date": "2022-08-28",
    "currency": "PHP",
    "amount": 250,
    "metadata": {
        "createdAt": "2022-09-02T23:36:12Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    },
    "description": "Rider incentive",
    "referenceId": "Order ID-234728692099"
}]

Historical transaction data is provided up to 12 months from date of account connection, if available from the data source.

Transaction Sources

Transactions from gig platforms can be used to assess income from alternative income sources, whether or not this is used as a primary or secondary income source for the user. Smile retrieves transactions up to 12 months from the date of connection to ensure you have enough data to make an informed decision for your customer.

Smile offers information from many typical gig platforms, such as:

ride-sharing platforms
delivery platforms
marketplace platforms
service and freelancing platforms

In certain cases, Smile also derives monthly income information from transactions through its Estimated Income user insight product.

Estimated Income

Where there is limited income information available, Smile can also provide additional derived income information from secondary data types such as government service contributions and transactions.

Based on available historical data, we calculate an estimated monthly income for the user and surface that information via our API, saving you additional computational overhead.

Sample Estimated Income Data

Estimated income is always returned as a monthly amount.

[{
    "id": "einc-123abc456def789abc123def456abc78",
    "month": "2022-07",
    "currency": "PHP",
    "baseAmount": 8500,
    "metadata": {
        "createdAt": "2022-09-01T01:44:18Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    }
}, {
    "id": "einc-123abc456def789abc123def456abc78",
    "month": "2022-06",
    "currency": "PHP",
    "baseAmount": 8500,
    "metadata": {
        "createdAt": "2022-09-01T01:44:18Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    }
}]

Fallback Methods

If the sources your user provides are not enough, you can also make use of Smile's Archive API to retrieve a user-uploaded payslip document.

Testing Transactions

Transactions can be tested in Smile API's Sandbox mode without the need to contact Smile API. See Testing in Sandbox mode for more information. In order to test against live items in Production mode, book a call with us to request access for your account.