April 2025

You can now get proof of payments for a transaction via API by calling the get proof of payment endpoint with the transaction reference.

GET
https://api-v3-sandbox.vertofx.com/profile/transaction-history/proof-of-payment/:reference


Sample response:
{
    "pop": "9399303029293748393843982993",
    "type": "SESSIONID"
}

POP: The proof of payment for the transaction.
Type: The name of the proof of payment. This is typically based on the scheme.

Added Request a Statement API

We've introduced a new API endpoint to allow you to request statements for your wallets, delivered directly to your email or via webhook.

This enables greater flexibility and automation in managing your financial records.

Endpoint: baseURL/statement/export

Query Parameters:

since: The start date of the statement (format: YYYY-MM-DD).
till: The end date of the statement (format: YYYY-MM-DD).
format: The desired format for the statement (csv or pdf). Defaults to csv if not specified. Request Body:

{
  "walletIds": [  0, 1  ],
  "email": "[email protected]"
}

walletIds: An array of wallet ID(s) for which you are requesting the statement.
email: The email address where the statement should be sent. If this field is empty, the response will be delivered via webhook. Response Body (Success):

\{  
  "statusCode": 202,
  "message": "The request is accepted and response will be delivered by webhook if the email was empty"
}

Response Body (Failure):

\{  
  "statusCode": 400,
  "message": "Invalid wallet Ids: 2, 3"
}

Statement Webhook Response:

webhook
{
  "eventId": "aa8603b2-4814-ea40-da5e-fe025fdeb36f",
  "eventType": "wallet.statement.generated",
  "createdAt": "2025-04-24T15:40:30.647Z",
  "event": {
    "walletId": 13164,
    "companyId": "2513",
    "createdAt": "2025-04-24T15:40:30.647Z",
    "dateFrom": "2024-12-12T00:00:00.000Z",
    "dateTill": "2025-04-17T23:59:59.000Z",
    "transactionCount": 11,
    "url": "https://verto-reports-local.s3.eu-central-1.amazonaws.com/Wallet%20Statement%20%28Thu%20Dec%2012%202024%20-%20Thu%20Apr%2017%202025%29%20%3A%205bdeeeb3-6ed2-5ea6-d6de-32239b2758e4.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAQJBHYLXIYE4245ZH%2F20250424%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20250424T154030Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEID%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDGV1LWNlbnRyYWwtMSJGMEQCIHGJCMq7%2FDPYCadec3JrV%2Bf%2BGlYI9bujx%2BUjOWP5n8kZAiALma9cJ3%2BCJ5tlAOGidpKEPy23FT6p2fYSiJvq3FiNKyr5AggZEAMaDDAxOTQxMDczODY0MSIMB7ezFZqUP%2BS8uM8KKtYCr2X7IVigHazjhs5BxZO9VN7qOCK5fsLx7iDrjTJ5z%2FKkKEzeMZ8afpTC4wq2WCjMA1kJv%2Fy7IdrneNhHPGZRA6EeUaj5xS0O6DfGioL8Ap%2BnJXlHUG9KzBhr6CItMEp015jG62tX73d70P28ws6JbEcBcJJLsiHiv1cTEA6tfKWiaQKRejzq4BokHvUyvrMkBjoE8Oum8%2B1EGaZRKjnCNFMIp3JmrA7Pxc0EP6EumfzQt2XJJgjm79DCXpsjlg%2FQE1ZgRNmjMHfEN%2F2cuZ8AOGmn6hivzJIzT2HW7XbgqlRFE1FCN7J2up9a2GIqg9hznlId757%2FWr%2FzMl2ENDQB%2FQEMYUMJgQXCpxZnTpBTsco%2BJxV7MMspGHXoLt3Na9qArYvlzRrph%2F3YFX7ACtWRtfyJ1qrZ%2FHrStVHu0J9fm%2BjDc2I044GJbTBZhq9X4OIY4vEtzjIEMOW2qcAGOp8BeLoaSKSjsOZ2XM1GtVtrvFllVTyAq5S0WcHXFyQ2D3GLvUEs%2FJbd6EfD%2BjOgB9isQmgqX6QFuh%2BAqjVv2iy45jbG1iOp1kM5rFsIp1g%2FRFsxWIuiq10Nfhzop3M%2BEG7fHEzX1xap5OPqb3rhmgU89xXbURwsqHKtRcoCkJb2rI1wMu5UA%2Bcst4xmrT9c9nuRM8JcHBbpy3yh0M4r2Dy2&X-Amz-Signature=720fe36272e81f6f1cfac2da84df6e0809bc3435dabe37279148696c3b3458a0&X-Amz-SignedHeaders=host&x-id=GetObject"
  }
}