Tpay
API

Collect

Collect is a service where funds from transactions are transferred directly to the accounts specified in the transaction parameters. Upon successful completion of the transaction, the funds are credited to the specified account number. Each provided account is verified and must be on the list of approved accounts assigned to the given merchant.

Note

To start accepting payments through the Collect service, you must sign the appropriate agreement and provide a list of supported accounts. Please contact the Customer Service Department to discuss the details and possibilities of activating the service.

Available Payment Methods

The following payment methods are available within the Collect service:

Transaction

Setting up a transaction in the Collect service is analogous to setting up a standard transaction and requires two mandatory parameters:

collect.account
Accepts 28 characters and an account number in IBAN format. Only Polish accounts are supported. To successfully set up a transaction, the account provided in the parameter must be on the merchant's list of accounts.
collect.receiver
Accepts uppercase and lowercase letters (a-z, A-Z) and Polish characters, digits (0-9), special characters: / - , . and spaces.

Example:

{
  "collect": {
    "account": "PL63105015201000009091194713",
    "receiver": "Odbiorca testowy"
  }
}

The basic request body should look like this:

{
  "amount": 10.21,
  "description": "Transakcja testowa collect",
  "lang": "pl",
  "payer": {
    "email": "[email protected]",
    "name": "Test Tpay",
    "phone": "123456789",
    "address": "Plac Andersa 3",
    "code": "11-123",
    "city": "Poznań",
    "country": "PL"
  },
  "collect": {
    "account": "PL63105015201000009091194713",
    "receiver": "Odbiorca testowy"
  }
}