NAV Navbar
API Reference

Introduction

API Production Endpoint

https://api.everypay.gr

API Sandbox Endpoint

https://sandbox-api.everypay.gr

This documentation will guide you through EveryPay REST API in order to show you how to authenticate, make requests, and retrieve data. Our API accepts form-encoded request bodies and returns responses in JSON format.

Authentication

Example authentication request

$ curl https://api.everypay.gr/payments \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: 

All requests to EveryPay API have to be authenticated and have to be made over HTTPS. Our API uses HTTP Basic Auth for authentication.

To authenticate you need to provide your API secret key, as username and leave the password blank. Some REST clients expect a username:password pair separated by a colon. Since there is no explicit password with the API key, it will need to be followed simply by a colon in those cases.

You can find you API keys in your account settings once you login to your account. Please keep your private keys secure and don’t pass them to anyone. These private keys have extreme secure information for handling the transactions of your account.

Errors

Error response example

{
    "error": {
        "status": 401,
        "code": 10000,
        "message": "Please provide a valid API key"
    }
}

The EveryPay API uses HTTP Status codes to reflect successful or error requests. 2XX status codes represent a successful request, 4XX/5XX status codes represent an error took place. If you receive an error HTTP status code, check the body for an error code and message.

Status Code Description Most Likely Cause
200 OK Successful request
400 Bad Request Request has invalid data or is missing a required field
401 Unauthorized Provided API key is missing or invalid
402 Payment Failed Request was valid but card processing has failed
404 Not Found Requested object was not found
409 Conflict The request conflicts with another request
500 Server Error Something wrong happened on our side
Resources

Payments

Payments are charges made with a payment card (credit, debit, prepaid).

The payment object

The payment object

{
    "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1000,
    "refund_amount": 0,
    "fee_amount": 48,
    "payee_email": null,
    "payee_phone": null,
    "merchant_ref": null,
    "card": {
        "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "split": false,
    "transfer_amount": 0,
    "transfers": []
}

Property Description
token string Unique identifier (ID) for the payment object. Always starts with the prefix pmt_.
date_created string The creation date of payment in ISO 8601 format.
description string A description of the payment.
amount integer The payment amount in the smallest currency unit e.g in cents.
currency string Currency represented as three-letter ISO 4217 code.
status string Indicates the payment status.
Captured
Failed
Refunded
Partially Refunded
Disputed
Pending
Pre Authorized
Canceled
Expired
refund_amount integer Amount refunded in cents which is less or equal than the payment amount.
fee_amount integer Service fee amount for the payment.
payee_email string The email address to which a payment receipt will be sent.
payee_phone string Customer’s phone number.
merchant_ref string A unique ID set by the merchant.
card object An object containing card details with which the payment was completed.
refunded boolean Indicates whether payment has been fully refunded. If the payment is only partially refunded, this attribute will still be false.
refunds list A list of refunds that have been applied to the payment.
installments_count integer An integer which indicates the installment count supplied to the payment.
installments list A list of installment objects that have been applied to the payment.
split boolean Whether the payment is a split payment.
transfer_amount integer Amount transferred in cents which is less or equal than the payment amount.
transfers list A list of transfers that have been applied to the payment.

Create a payment

Definition

POST https://api.everypay.gr/payments

Example request with card data

$ curl https://api.everypay.gr/payments \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d card_number=4111111111111111 \
  -d expiration_year=2022 \
  -d expiration_month=05 \
  -d holder_name="John Doe" \
  -d cvv=123 \
  -d amount=1000 \
  -d description="Order #GGA-435167" 

Example request with card token

$ curl https://api.everypay.gr/payments \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d token=ctn_KJ53Qx3ZGaNLttUNxyB5JQO3 \
  -d amount=1000 \
  -d description="Order #GGA-435167"

Example request with customer token

$ curl https://api.everypay.gr/payments \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d token=cus_RxE6DEcITxOYyynErDK6VoBa \
  -d amount=1000 \
  -d description="Order #GGA-435167"

Example Response

200 OK
{
    "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1000,
    "refund_amount": 0,
    "fee_amount": 48,
    "payee_email": null,
    "payee_phone": null,
    "merchant_ref": null,
    "card": {
        "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "split": false,
    "transfer_amount": 0,
    "transfers": []
}

You can create a payment by charging a payment card using one of the following, as shown in the examples:

Body Arguments  
amount required A positive integer in the smallest currency unit e.g in cents (e.g 10,99 EUR shall be converted to 1099).
card arguments optional All required fields of the Card Arguments.
token optional It can be either a Card Token ID or a Customer ID.
card optional In case a payment is made with a Customer ID you can define which card of the customer will be charged by providing a valid Card ID. If this atrribute is skipped then the customer’s default card will be used.
description optional A description of the payment.
capture optional
1
Whether to immediately capture the payment.
1 payment will be captured.
0 only a pre-authorize request will be send in order to hold on the amount. In that case you have to capture the payment in a second step.
payee_email optional Provide the email address to which a payment receipt will be sent. This will override a customer’s email address in case payment is made with a customer token.
payee_phone optional Provide the customer’s phone.
installments optional A positive integer indicating the number of installments which the payer has applied to. Max. installment count is 36 and depends on merchant’s configuration. If card or merchant account doesn’t support installments an error will be thrown.
max_installments optional A positive integer indicating the maximum count of allowed installments. This value is taken into account only if in the token parameter a Token ID is passed. This will ensure that the max. installment value of the token matches the provided value. If a mismatch is encountered then an error will be thrown.
merchant_ref optional A unique ID set by the merchant. The merchant reference ID remains the same throughout the lifetime of the payment. Maximum chars 120. If a payment with the same merchant reference ID is again submitted then an error will be thrown.
create_customer optional
0
1 after a successfull payment a customer object is created and the payment card is assigned to it as default card.
0 no customer object is created.
customer optional By providing a Customer ID along with the payment details, the payment and the Card is assigned to the specified customer. This is useful if in case a customer is paying with a new card and you want to avoid multiple API calls.
default_card optional
0
Shall be used in conjuction with the customer parameter.
1 If the payment succeeds the used card will be assigned to the above customer object and marked as default.
0 the card will be added to the list of cards of the customer object.
split optional
0
Whether the payment will be split into transfers.
1 Payment is marked a split payment and awaits transfer data with additional requests.
0 Payment is processed as a non-marketplace payment and funds will be deposited to your account.

Retrieve a payment

Definition

GET https://api.everypay.gr/payments/{paymentId}

Example Request

$ curl https://api.everypay.gr/payments/pmt_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1000,
    "refund_amount": 0,
    "fee_amount": 48,
    "payee_email": null,
    "payee_phone": null,
    "merchant_ref": null,
    "card": {
        "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "split": false,
    "transfer_amount": 0,
    "transfers": []
}

Retrieves the details of a payment. Provide the unique payment ID that was returned from the creation call.

Path Arguments  
paymentId required The unique Payment ID.

Capture a payment

Definition

PUT https://api.everypay.gr/payments/{paymentId}/capture

Example Request

$ curl https://api.everypay.gr/payments/pmt_lkPJrywRlDAp5oKrqOeRHEt0/capture \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -X PUT

Example Response

200 OK
{
    "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1000,
    "refund_amount": 0,
    "fee_amount": 48,
    "payee_email": null,
    "payee_phone": null,
    "merchant_ref": null,
    "card": {
        "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "split": false,
    "transfer_amount": 0,
    "transfers": []
}

Capture a previous per-authorized payment that was created with captured=0 argument. This is the second part of the two step payment flow.

Path Arguments  
paymentId required The unique Payment ID.

Update a payment

Definition

PUT https://api.everypay.gr/payments/{paymentId}

Example Request

$ curl https://api.everypay.gr/payments/pmt_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d description="Order #23" \
  -X PUT

Example Response

200 OK
{
  "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
  "date_created": "2019-02-14T19:47:03+0200",
  "description": "Order #23",
  "currency": "EUR",
  "status": "Captured",
  "amount": 1000,
  "refund_amount": 0,
  "fee_amount": 48,
  "payee_email": null,
  "payee_phone": null,
  "merchant_ref": null,
  "card": {
    "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
    "expiration_month": "05",
    "expiration_year": "2022",
    "bin": "411111",
    "last_four": "1111",
    "type": "Visa",
    "holder_name": "John Doe",
    "supports_installments": false,
    "status": "valid",
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
      "enrolled": null,
      "eci_flag": null,
      "auth_code": null,
      "auth_desc": null
    }
  },
  "refunded": false,
  "refunds": [

  ],
  "installments_count": 0,
  "installments": [

  ],
  "split": true,
  "transfer_amount": 0,
  "transfers": [

  ]
}

Update an existing payment’s information. Any not provided parameter will be left unchanged.

Path Arguments  
paymentId required The Payment ID.
Body Arguments  
description optional A description of your payment object.

List all payments

Definition

GET https://api.everypay.gr/payments

Example Request

$ curl https://api.everypay.gr/payments?count=5&offset=0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 381,
    "items": [
        {
            "token": "pmt_lkPJrywRlDAp5oKrqOeRHEt0",
            "date_created": "2019-02-14T19:47:03+0200",
            "description": "Order #GGA-435167",
            "currency": "EUR",
            "status": "Captured",
            "amount": 1000,
            "refund_amount": 0,
            "fee_amount": 48,
            "payee_email": null,
            "payee_phone": null,
            "merchant_ref": null,
            "card": {
                "token": "crd_U0FBPmz5t2zjDjKaOGABlo6A",
                "expiration_month": "05",
                "expiration_year": "2019",
                "bin": "411111",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "status": "valid",
                "friendly_name": "Visa •••• 1111 (05/2019)",
                "tds": {
                    "enrolled": null,
                    "eci_flag": null,
                    "auth_code": null,
                    "auth_desc": null
                }
            },
            "refunded": false,
            "refunds": [],
            "installments_count": 0,
            "installments": [],
            "split": false,
            "transfer_amount": 0,
            "transfers": []
        },
        {...},
        {...},
        {...},
        {...}
    ]
}

Returns a list of payments. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
merchant_ref optional Provide the unique merchant reference ID used in the payment creation call.

Refunds

Refunds allow you to refund a payment. The refunded amount will be credited to the payment card that was originally charged.

The refund object

The refund object

{
    "token": "ref_ew6fZqrUbWrfCQuPgcSjeYD7",
    "date_created": "2019-02-15T18:54:38+0300",
    "status": "Captured",
    "amount": 10000,
    "fee_amount": 120,
    "description": "Refund for Order #123",
    "payment": "pmt_UKQs1FCubxhtOdVIGfZPt1ER"
}

Property Description
token string Unique identifier (ID) for the refund object. Always starts with the prefix ref_.
date_created string The creation date of refund in ISO 8601 format.
status string Indicates the refund status.
Captured
Failed
amount integer The refund amount in the smallest currency unit e.g in cents.
fee_amount integer The service fee amount that is refunded as well, and is calculated proportionally to the refund amount.
description string The refund reason.
payment string A Payment ID of the payment that was refunded.

Create a refund

Definition

POST https://api.everypay.gr/refunds

Example request

$ curl https://api.everypay.gr/refunds \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d payment=pmt_UKQs1FCubxhtOdVIGfZPt1ER \
  -d amount=10000 \
  -d description="Refund for Order #123"

Example Response

200 OK
{
    "token": "ref_ew6fZqrUbWrfCQuPgcSjeYD7",
    "date_created": "2019-02-15T18:54:38+0300",
    "status": "Captured",
    "amount": 10000,
    "fee_amount": 120,
    "description": "Refund for Order #123",
    "payment": "pmt_UKQs1FCubxhtOdVIGfZPt1ER"
}

Refund an existing payment, which will result in funds being returned to the previously charged payment card. It is possible to only refund part of captured payment. This partial refund can be repeated for as long as the payment is not fully refunded.

Body Arguments  
payment required The Payment ID of the payment to refund.
amount optional The amount (in cents) to refund. This must be less or equal to current amount of payment that is being refunded. If no amount is provided then the remaining amount of payment will be used.
description optional Useful to describe the refund reason.

Retrieve a refund

Definition

GET https://api.everypay.gr/refunds/{refundId}

Example Request

$ curl https://api.everypay.gr/refunds/ref_ew6fZqrUbWrfCQuPgcSjeYD7 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "ref_ew6fZqrUbWrfCQuPgcSjeYD7",
    "date_created": "2019-02-15T18:54:38+0300",
    "status": "Captured",
    "amount": 10000,
    "fee_amount": 120,
    "description": "Refund for Order #123",
    "payment": "pmt_UKQs1FCubxhtOdVIGfZPt1ER"
}

Retrieves the details of a refund. Provide the unique refund ID that was returned from the creation call.

Path Arguments  
refundId required The unique Refund ID.

List all refunds

Definition

GET https://api.everypay.gr/refunds

Example Request

$ curl https://api.everypay.gr/refunds \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 122,
    "items": [
        {
            "token": "ref_ew6fZqrUbWrfCQuPgcSjeYD7",
            "date_created": "2019-02-15T18:54:38+0300",
            "status": "Captured",
            "amount": 10000,
            "fee_amount": 120,
            "description": "Refund for Order #123",
            "payment": "pmt_UKQs1FCubxhtOdVIGfZPt1ER"
        },
        {...},
        {...},
        {...},
        {...}
    ]
}

Returns a list of refunds. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
payment optional Provide the Payment ID to fetch refunds only for the specified payment.

Tokens

Tokens are used in case you do not want to process or store sensitive card data, such as card number or CVV, on your servers. They can be easily obtained with the use of the EveryPay Button, but you can also create tokens, via our API, in other environments (for example in mobile apps).

Tokens can be created by using either your Public Key or your Secret Key. You can safely embed your Public Key in JavaScript frontend apps or mobile apps (such as iOS or Android), in order to avoid processing of sensitive card data.

The token object

The token object

{
  "token": "ctn_KJ53Qx3ZGaNLttUNxyB5JQO3",
  "is_used": false,
  "has_expired": false,
  "amount": 1000,
  "date_created": "2019-02-14T16:51:46+0200",
  "card": {
    "token": "crd_N9YNHC2TUskLo2hWNi3BkK8Z",
    "expiration_month": "05",
    "expiration_year": "2022",
    "bin": "411111",
    "last_four": "1111",
    "type": "Visa",
    "holder_name": "John Doe",
    "supports_installments": false,
    "max_installments": 0,
    "status": "valid",
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
      "enrolled": null,
      "eci_flag": null,
      "auth_code": null,
      "auth_desc": null
    }
  }
}

Property Description
token string Unique identifier (ID) for the token object. Always starts with the prefix ctn_.
is_used boolean Determines whether this token has already been used.
has_expired boolean Determines whether the token has expired. If token has expired it can not be used in any transaction.
amount integer A positive integer in the smallest currency unit e.g in cents (e.g 10,99 EUR shall be converted to 1099). You can use this to bind the specific token with the provided amount.
date_created string The creation date of token in ISO 8601 format.
card object A card object containing the card details.

Create a token

Definition

POST https://api.everypay.gr/tokens

Example Request

$ curl https://api.everypay.gr/tokens \
  -u pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8: \
  -d card_number=411111111111111 \
  -d expiration_year=2022 \
  -d expiration_month=05 \
  -d cvv=334 \
  -d holder_name="John Doe" \
  -d amount=1000

Example Response

200 OK
{
  "token": "ctn_KJ53Qx3ZGaNLttUNxyB5JQO3",
  "is_used": false,
  "has_expired": false,
  "amount": 1000,
  "date_created": "2019-02-14T16:51:46+0200",
  "card": {
    "token": "crd_N9YNHC2TUskLo2hWNi3BkK8Z",
    "expiration_month": "05",
    "expiration_year": "2022",
    "bin": "411111",
    "last_four": "1111",
    "type": "Visa",
    "holder_name": "John Doe",
    "supports_installments": false,
    "max_installments": 0,
    "status": "valid",
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
      "enrolled": null,
      "eci_flag": null,
      "auth_code": null,
      "auth_desc": null
    }
  }
}

Creates a single-use token that represents a payment card’s details.

Body Arguments  
card arguments required All required fields of the Card Arguments.
amount optional A positive integer in the smallest currency unit e.g in cents (e.g 10,99 EUR shall be converted to 1099).

Retrieve a token

Definition

GET https://api.everypay.gr/tokens/{tokenId}

Example Request

$ curl https://api.everypay.gr/tokens/ctn_KJ53Qx3ZGaNLttUNxyB5JQO3 \
  -u pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8:

Example Response

200 OK
{
  "token": "ctn_KJ53Qx3ZGaNLttUNxyB5JQO3",
  "is_used": false,
  "has_expired": false,
  "amount": 1000,
  "date_created": "2019-02-14T16:51:46+0200",
  "card": {
    "token": "crd_N9YNHC2TUskLo2hWNi3BkK8Z",
    "expiration_month": "05",
    "expiration_year": "2022",
    "bin": "411111",
    "last_four": "1111",
    "type": "Visa",
    "holder_name": "John Doe",
    "supports_installments": false,
    "max_installments": 0,
    "status": "valid",
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
      "enrolled": null,
      "eci_flag": null,
      "auth_code": null,
      "auth_desc": null
    }
  }
}

Retrieve an existing token object.

Path Arguments  
tokenId required The unique Token ID.

Customers

Customers allows you to store multiple tokenized cards for later use on a single object. Customers are useful for tracking payments and perform recurring payment that are associated with the same entity.

The customer object

The customer object

{
    "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "description": "Club Member",
    "email": "cofounder@themail.com",
    "date_created": "2019-02-14T17:50:09+0200",
    "full_name": "John Doe",
    "is_active": true,
    "date_modified": "2019-02-14T17:50:09+0200",
    "card": {
        "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "cards": {
        "count": 1,
        "data": [
            {
                "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
                "expiration_month": "05",
                "expiration_year": "2022",
                "bin": "411111",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "max_installments": 0,
                "status": "valid",
                "friendly_name": "Visa •••• 1111 (05/2022)",
                "tds": {
                    "enrolled": null,
                    "eci_flag": null,
                    "auth_code": null,
                    "auth_desc": null
                }
            }
        ]
    }
}

Property Description
token string Unique identifier (ID) for the customer object. Always starts with the prefix cus_.
description string A description of your customer object.
full_name string Customer’s full name.
email string Customer’s email address. In case a payment is made with a customer object this address will be used to send a payment receipt.
date_created string The creation date of customer in ISO 8601 format.
is_active boolean Indicates if customer is active. Inactive customer cannot longer perform any payments.
date_modified string The latest modification date of customer in ISO 8601 format.
card object An object containing card details which indicates the customer’s default card as well.
cards list A list of cards associated with this customer.

Create a customer

Definition

POST https://api.everypay.gr/customers

Example request with card data

$ curl https://api.everypay.gr/customers \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d card_number=4111111111111111 \
  -d expiration_year=2022 \
  -d expiration_month=05 \
  -d holder_name="John Doe" \
  -d email=customer@themail.com \
  -d description="Club Member" \
  -d full_name="John Doe"

Example request with card token

$ curl https://api.everypay.gr/customers \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d token=ctn_KJ53Qx3ZGaNLttUNxyB5JQO3 \
  -d email=customer@themail.com \
  -d description="Club Member" \
  -d full_name="John Doe"

Example Response

200 OK
{
    "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "description": "Club Member",
    "email": "cofounder@themail.com",
    "date_created": "2019-02-14T17:50:09+0200",
    "full_name": "John Doe",
    "is_active": true,
    "date_modified": "2019-02-14T17:50:09+0200",
    "card": {
        "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "cards": {
        "count": 1,
        "data": [
            {
                "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
                "expiration_month": "05",
                "expiration_year": "2022",
                "bin": "411111",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "max_installments": 0,
                "status": "valid",
                "friendly_name": "Visa •••• 1111 (05/2022)",
                "tds": {
                    "enrolled": null,
                    "eci_flag": null,
                    "auth_code": null,
                    "auth_desc": null
                }
            }
        ]
    }
}

You can create a customer object by providing one of the following, as shown in the examples:

Body Arguments  
card arguments optional All required fields of the Card Arguments, except card’s CVV.
token optional An unused and non expired Card Token ID.
description optional A description of your customer object.
full_name optional Customer’s full name.
email optional Customer’s email address. This address is used in order to send the payment receipt.

Retrieve a customer

Definition

GET https://api.everypay.gr/customers/{customerId}

Example Request

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "description": "Club Member",
    "email": "cofounder@themail.com",
    "date_created": "2019-02-14T17:50:09+0200",
    "full_name": "John Doe",
    "is_active": true,
    "date_modified": "2019-02-14T17:50:09+0200",
    "card": {
        "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
            "enrolled": null,
            "eci_flag": null,
            "auth_code": null,
            "auth_desc": null
        }
    },
    "cards": {
        "count": 1,
        "data": [
            {
                "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
                "expiration_month": "05",
                "expiration_year": "2022",
                "bin": "411111",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "max_installments": 0,
                "status": "valid",
                "friendly_name": "Visa •••• 1111 (05/2022)",
                "tds": {
                    "enrolled": null,
                    "eci_flag": null,
                    "auth_code": null,
                    "auth_desc": null
                }
            }
        ]
    }
}

Retrieve an existing customer object.

Path Arguments  
customerId required The unique Customer ID.

Update a customer

Definition

PUT https://api.everypay.gr/customers/{customerId}

Example update request of customer’s details

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d email="newmail@example.com" \
  -d full_name="Steve Doe" \
  -d description="Silver Member" \
  -X PUT

Example update request of customer’s default card

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d card=crd_xDQhOiVCyKFcUphQMEdUPuXQ
  -d default_card=1
  -X PUT

Example Response

200 OK
{
  "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
  "description": "Silver Member",
  "email": "newmail@example.com",
  "date_created": "2019-02-14T17:50:09+0200",
  "full_name": "Steve Doe",
  "is_active": true,
  "date_modified": "2019-02-14T17:50:09+0200",
  "card": {
    "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
    "expiration_month": "05",
    "expiration_year": "2022",
    "bin": "411111",
    "last_four": "1111",
    "type": "Visa",
    "holder_name": "John Doe",
    "supports_installments": false,
    "max_installments": 0,
    "status": "valid",
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
      "enrolled": null,
      "eci_flag": null,
      "auth_code": null,
      "auth_desc": null
    }
  },
  "cards": {
    "count": 1,
    "data": [
      {
        "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
        "expiration_month": "05",
        "expiration_year": "2022",
        "bin": "411111",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0,
        "status": "valid",
        "friendly_name": "Visa •••• 1111 (05/2022)",
        "tds": {
          "enrolled": null,
          "eci_flag": null,
          "auth_code": null,
          "auth_desc": null
        }
      }
    ]
  }
}

Update an existing customer’s information. Any not provided parameter will be left unchanged.

Path Arguments  
customerId required The Customer ID.
Body Arguments  
description optional A description of your customer object.
full_name optional Customer’s full name.
email optional Customer’s email address. This address is used in order to send the payment receipt.
card optional The Card ID.
default_card optional
0
Whether to set provided card as default.
1 mark card as default.
0 no change is performed.

Delete a customer

Definition

DELETE https://api.everypay.gr/customers/{customerId}

Example Request

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -X DELETE

Example Response

200 OK
{
    "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "description": "Club Member",
    "email": "customer@themail.com",
    "date_created": "2019-02-14T17:50:09+0200",
    "full_name": "John Doe",
    "is_active": false,
    "date_modified": "2019-02-14T17:50:09+0200"
}

Deletes an existing customer object.

Path Arguments  
customerId required The unique Customer ID.

List all customers

Definition

GET https://api.everypay.gr/customers

Example Request

$ curl https://api.everypay.gr/customers?count=5&offset=0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 122,
    "items": [
        {
            "token": "cus_RxE6DEcITxOYyynErDK6VoBa",
            "description": "Club Member",
            "email": "customer@themail.com",
            "date_created": "2019-02-14T17:50:09+0200",
            "full_name": "John Doe",
            "is_active": true,
            "date_modified": "2019-02-14T17:50:09+0200",
            "card": {
                "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
                "expiration_month": "05",
                "expiration_year": "2022",
                "bin": "411111",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "status": "valid",
                "friendly_name": "Visa •••• 1111 (05/2022)",
                "tds": {
                    "enrolled": null,
                    "eci_flag": null,
                    "auth_code": null,
                    "auth_desc": null
                }
            },
            "cards": {
                "count": 1,
                "data": [
                    {
                        "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
                        "expiration_month": "05",
                        "expiration_year": "2022",
                        "bin": "411111",
                        "last_four": "1111",
                        "type": "Visa",
                        "holder_name": "John Doe",
                        "supports_installments": false,
                        "status": "valid",
                        "friendly_name": "Visa •••• 1111 (05/2022)",
                        "tds": {
                            "enrolled": null,
                            "eci_flag": null,
                            "auth_code": null,
                            "auth_desc": null
                        }
                    }
                ]
            }
        },
        {...},
        {...},
        {...},
        {...}
    ]
}

Returns a list of customers. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.

Cards

Cards are representing a payment card (credit, debit, prepaid) and are used to save card data for later use.

Cards can also be used to represent card data in other operations (for example to specify card data when creating a new Payment or a Token).

The card object

The card object

{
    "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
    "type": "Visa",
    "bin": "411111",
    "last_four": "1111",
    "expiration_month": "05",
    "expiration_year": "2022",
    "holder_name": "John Doe",
    "status": "valid",
    "customer": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "supports_installments": false,
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
        "enrolled": null,
        "eci_flag": null,
        "auth_code": null,
        "auth_desc": null
    }
}

Property Description
token string Unique identifier (ID) for the card object. Always starts with the prefix crd_.
type string The card type (Visa, MasterCard, etc.).
bin string The first six digits of the payment card number.
last_four string The last four digits of the card number.
expiration_month string A two-digit number representing the expiration month of a card (e.g., 08 for August).
expiration_year string A four-digit number representing the expiration year of a card (e.g. 2022).
holder_name string The cardholder’s name.
status string Indicates the card status.
valid
expired
customer string A Customer ID that is owner of this card.
supports_installments boolean Indicates if card supports installments.
friendly_name string A friendly representation of card’s data.
tds.enrolled string tds.enrolled
tds.eci_flag string tds.eci_flag
tds.auth_code string tds.auth_code
tds.auth_desc string tds.auth_desc

Create a card

Definition

POST https://api.everypay.gr/customers/{customerId}/cards

Example request with card data

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa/cards \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d card_number=4111111111111111 \
  -d expiration_year=2022 \
  -d expiration_month=05 \
  -d holder_name="John Doe" \
  -d default_card=1

Example request with card token

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa/cards \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d token=ctn_KJ53Qx3ZGaNLttUNxyB5JQO3

Example Response

200 OK
{
    "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
    "type": "Visa",
    "bin": "411111",
    "last_four": "1111",
    "expiration_month": "05",
    "expiration_year": "2022",
    "holder_name": "John Doe",
    "status": "valid",
    "customer": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "supports_installments": false,
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
        "enrolled": null,
        "eci_flag": null,
        "auth_code": null,
        "auth_desc": null
    }
}

You can add a new card to an existing customer by providing, the same arguments as in a Create Customer call. By providing the argument default_card=1 you can set the newly created card as the customer’s default card.

Path Arguments  
customerId required The unique Customer ID.
Body Arguments  
card arguments optional All required fields of the Card Arguments, except card’s CVV.
token optional An unused and non expired Card Token ID.
default_card optional
0
Whether to set provided card as default.
1 mark card as default.
0 no change is performed.

Retrieve a card

Definition

GET https://api.everypay.gr/customers/{customerId}/cards/{cardId}

Example Request

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa/cards/crd_xDQhOiVCyKFcUphQMEdUPuXQ \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
    "type": "Visa",
    "bin": "411111",
    "last_four": "1111",
    "expiration_month": "05",
    "expiration_year": "2022",
    "holder_name": "John Doe",
    "status": "valid",
    "customer": "cus_RxE6DEcITxOYyynErDK6VoBa",
    "supports_installments": false,
    "friendly_name": "Visa •••• 1111 (05/2022)",
    "tds": {
        "enrolled": null,
        "eci_flag": null,
        "auth_code": null,
        "auth_desc": null
    }
}

Retrieve details of an existing card object that belongs to a customer.

Path Arguments  
customerId required The unique Customer ID.
cardId required The unique Card ID.

Delete a card

Definition

DELETE https://api.everypay.gr/customers/{customerId}/cards/{cardId}

Example Request

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa/cards/crd_FIAoNSiXlwpnSJrfojsrPdH4 \
 -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
 -X DELETE

Example Response

200 OK
{
  "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
  "is_deleted": true
}

You can delete a customer card by using this resource. If you delete a card that is the default card then the most recently added card will be used as new default card.

Path Arguments  
customerId required The unique Customer ID.
cardId required The unique Card ID.

List all cards

Definition

GET https://api.everypay.gr/customers/{customerID}/cards

Example Request

$ curl https://api.everypay.gr/customers/cus_RxE6DEcITxOYyynErDK6VoBa/cards \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 3,
    "items": [
        {
            "token": "crd_xDQhOiVCyKFcUphQMEdUPuXQ",
            "type": "Visa",
            "bin": "411111",
            "last_four": "1111",
            "expiration_month": "05",
            "expiration_year": "2022",
            "holder_name": "John Doe",
            "status": "valid",
            "customer": "cus_RxE6DEcITxOYyynErDK6VoBa",
            "supports_installments": false,
            "friendly_name": "Visa •••• 1111 (05/2022)",
            "tds": {
                "enrolled": null,
                "eci_flag": null,
                "auth_code": null,
                "auth_desc": null
            }
        },
        {...},
        {...}
    ]
}

Returns a list of the cards belonging to a customer. You can use the below parameters to limit the results and paginate through the list.

Path Arguments  
customerId required The unique Customer ID.
cardId required The unique Card ID.
Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.

Balance

The balance object represents your account balance.

The balance object

The balance object

{
    "marketplace": {
        "available_amount": 40000,
        "current_amount": 200000,
    }
}

Property Description
marketplace.available_amount integer The available balance of your marketplace account. This amount occurs from funds that are collected from transfer commissions or from direct credit transfers.
marketplace.current_amount integer Represents the current balance of your marketplace account. This amount occurs from unsettled seller payments.

Retrieve balance

Definition

GET https://api.everypay.gr/balance

Example Request

$ curl https://api.everypay.gr/balance \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "marketplace": {
        "available_amount": 40000,
        "current_amount": 200000,
    }
}

Retrieves the balance details of your account.

Path Arguments  

No arguments required

Link

Sellers

To start accepting payments on your marketplace and on behalf of your sellers, you need to onboard them first to EveryPay Link.

With EveryPay Link, you will be able to perform the following:

The seller object

The seller object

{
    "token": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "date_modified": "2019-02-14T17:50:09+0200",
    "status": "Authorized",
    "is_authorized": true,
    "email": "seller1@example.com",
    "contact_phone": "+302109999999",
    "description": "Seller #1",
    "business": {
        "name": "Acme Corporation Societe Anonyme",
        "title": "Acme S.A",
        "tax_number": "999000999",
        "address": "Sesame St. 23"
    },
    "bank_accounts": [
        {
            "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
            "date_created": "2019-02-14T17:50:09+0200",
            "iban": "GR6501101100000011047025496",
            "bank_name": "NATIONAL BANK OF GREECE S.A.",
            "beneficiary_name": "John Doe",
            "is_default": true
        }
    ],
    "payout_interval": "weekly",
    "payout_frequency": [
        "monday",
        "friday"
    ],
    "payout_threshold_amount": 0
}

Property Description
token string Unique identifier (ID) for the seller object. Always starts with the prefix sel_.
date_created string The creation date of the seller object in ISO 8601 format.
date_modified string Last modification date and time of the seller object.
status string Indicates the seller’s status.
Authorized
Suspended
Closed
is_authorized bool Indicates if the seller can receive transfers. Is true only if the status is Authorized.
email string The email address of the seller.
contact_phone string The contact phone of the seller.
description string A short description of the seller.
business_name string The name of the seller’s business.
business_title string The distinctive title of the seller’s business.
business_tax_number string The tax number of the seller’s business.
bank_accounts list A list of the seller’s bank accounts.
business_address string The address of the seller’s business.
payout_interval string Indicates the payout interval.
daily
weekly
monthly
payout_frequency list Indicates the frequency of the payout_interval property.
payout_threshold_amount integer Indicates the seller’s minimum threshold payout amount.

Create a seller

Definition

POST https://api.everypay.gr/sellers

Example Request

$ curl https://api.everypay.gr/sellers \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d email="seller1@example.com" \
  -d contact_phone="+302109999999" \
  -d description="Seller #1" \
  -d business_name="Acme Corporation Societe Anonyme" \
  -d business_title="Acme S.A" \
  -d business_tax_number="999000999" \
  -d business_address="Sesame St. 23" \
  -d bank_account_iban="GR6501101100000011047025496" \
  -d bank_account_beneficiary="John Doe" \
  -d payout_interval="weekly" \
  -d payout_frequency="monday,friday"

Example Response

200 OK
{
    "token": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "date_modified": "2019-02-14T17:50:09+0200",
    "status": "Authorized",
    "is_authorized": true,
    "email": "seller1@example.com",
    "contact_phone": "+302109999999",
    "description": "Seller #1",
    "business": {
        "name": "Acme Corporation Societe Anonyme",
        "title": "Acme S.A",
        "tax_number": "999000999",
        "address": "Sesame St. 23"
    },
    "bank_accounts": [
        {
            "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
            "date_created": "2019-02-14T17:50:09+0200",
            "iban": "GR6501101100000011047025496",
            "bank_name": "NATIONAL BANK OF GREECE S.A.",
            "beneficiary_name": "John Doe",
            "is_default": true
        }
    ],
    "payout_interval": "weekly",
    "payout_frequency": [
        "monday",
        "friday"
    ],
    "payout_threshold_amount": 0
}

Through this endpoint you can create a seller object.

Body Arguments  
email required The email address of the seller.
contact_phone required The contact phone of the seller.
description required A description of your seller object.
business_name required The name of the seller’s business.
business_title required The distinctive title of the seller’s business.
business_tax_number required The tax number of the seller’s business.
business_address required The address of the seller’s business.
bank_account_iban required The seller’s IBAN account number.
bank_account_beneficiary required The beneficiary name of the seller’s bank account.
payout_interval optional
daily
Indicates the payout interval.
daily
weekly
monthly
payout_frequency optional This property contains a comma separated list of values.
For a weekly interval the allowed values are monday, tuesday, wednesday, thursday, friday.

For a monthly interval you may pass the days of the month the payout should be done. E.g:
1 The payout is done every 1st of every month.
1,11,21 The payout is done every 1st, 11th and 21st of every month.
15,31 The payout is done every 15th and every last day of every month.
Payouts scheduled between the 29th and 31st of the month are processed on the last day of shorter months.
payout_threshold_amount optional
0
A positive integer in the smallest currency unit e.g in cents, which will be considered as the minimum threshold amount for payout creation. If the seller’s balance exceeds this threshold then the payout will be created.

Retrieve a seller

Definition

GET https://api.everypay.gr/sellers/{sellerId}

Example Request

$ curl https://api.everypay.gr/sellers/sel_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "date_modified": "2019-02-14T17:50:09+0200",
    "status": "Authorized",
    "is_authorized": true,
    "email": "seller1@example.com",
    "contact_phone": "+302109999999",
    "description": "Seller #1",
    "business": {
        "name": "Acme Corporation Societe Anonyme",
        "title": "Acme S.A",
        "tax_number": "999000999",
        "address": "Sesame St. 23"
    },
    "bank_accounts": [
        {
            "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
            "date_created": "2019-02-14T17:50:09+0200",
            "iban": "GR6501101100000011047025496",
            "bank_name": "NATIONAL BANK OF GREECE S.A.",
            "beneficiary_name": "John Doe",
            "is_default": true
        }
    ],
    "payout_interval": "weekly",
    "payout_frequency": [
        "monday",
        "friday"
    ],
    "payout_threshold_amount": 0
}

Retrieve an existing seller object.

Path Arguments  
sellerId required The unique Seller ID.

Update a seller

Definition

PUT https://api.everypay.gr/sellers/{sellerId}

Example Request

$ curl https://api.everypay.gr/sellers/sel_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d email="seller1@newmail.com" \
  -d business_address="Sesame St. 25" \
  -d description="Seller new description #2" \
  -d payout_frequency="monday,thursday" \
  -X PUT

Example Response

200 OK
{
  "token": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
  "date_created": "2019-02-14T19:47:03+0200",
  "date_modified": "2019-02-14T17:50:09+0200",
  "status": "Authorized",
  "is_authorized": true,
  "email": "seller1@newmail.com",
  "contact_phone": "+302109999999",
  "description": "Seller new description #2",
  "business": {
    "name": "Acme Corporation Societe Anonyme",
    "title": "Acme S.A",
    "tax_number": "999000999",
    "address": "Sesame St. 25"
  },
  "bank_accounts": [
    {
      "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
      "date_created": "2019-02-14T17:50:09+0200",
      "iban": "GR6501101100000011047025496",
      "bank_name": "NATIONAL BANK OF GREECE S.A.",
      "beneficiary_name": "John Doe",
      "is_default": true
    }
  ],
  "payout_interval": "weekly",
  "payout_frequency": [
    "monday",
    "thursday"
  ],
  "payout_threshold_amount": 0
}

Update an existing seller’s information. Any not provided parameter will be left unchanged.

Path Arguments  
sellerId required The Seller ID.
Body Arguments  
email optional The email address of the seller.
description optional A description of your seller object.
business_name optional The name of the seller’s business.
business_title optional The distinctive title of the seller’s business.
business_address optional The address of the seller’s business.
payout_interval optional Indicates the payout interval.
daily
weekly
monthly
payout_frequency optional This property contains a comma separated list of values.
For a weekly interval the allowed values are monday, tuesday, wednesday, thursday, friday.

For a monthly interval you may pass the days of the month the payout should be done. E.g:
1 The payout is done every 1st of every month.
1,11,21 The payout is done every 1st, 11th and 21st of every month.
15,31 The payout is done every 15th and every last day of every month.
Payouts scheduled between the 29th and 31st of the month are processed on the last day of shorter months.
payout_threshold_amount optional
0
A positive integer in the smallest currency unit e.g in cents, which will be considered as the minimum threshold amount for payout creation. If the seller’s balance exceeds this threshold then the payout will be created.

List all sellers

Definition

GET https://api.everypay.gr/sellers

Example Request

$ curl https://api.everypay.gr/sellers?count=10 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 23,
    "items": [
        {
            "token": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
            "date_created": "2019-02-14T19:47:03+0200",
            "date_modified": "2019-02-14T17:50:09+0200",
            "status": "Authorized",
            "is_authorized": true,
            "email": "seller1@example.com",
            "contact_phone": "+302109999999",
            "description": "Seller #1",
            "business": {
                "name": "Acme Corporation Societe Anonyme",
                "title": "Acme S.A",
                "tax_number": "999000999",
                "address": "Sesame St. 23"
            },
            "bank_accounts": [
                {
                    "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
                    "date_created": "2019-02-14T17:50:09+0200",
                    "iban": "GR6501101100000011047025496",
                    "bank_name": "NATIONAL BANK OF GREECE S.A.",
                    "beneficiary_name": "John Doe",
                    "is_default": true
                }
            ],
            "payout_interval": "weekly",
            "payout_frequency": [
                "monday",
                "friday"
            ],
            "payout_threshold_amount": 0
        },
        {...},
        {...}
    ]
}

Returns a list of sellers. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
tax_number optional Provide a tax_number filter.

Retrieve a seller’s balance

Definition

GET https://api.everypay.gr/sellers/{sellerId}/balance

Example Request

$ curl https://api.everypay.gr/sellers/sel_lkPJrywRlDAp5oKrqOeRHEt0/balance \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "available_amount": 10000
}

Retrieve a seller’s account balance.

Path Arguments  
sellerId required The unique Seller ID.

Transfers

Transfers are used by marketplaces and have two types.

The payment transfer splits the funds from a payment to one or multiple sellers. A marketplace commission fee can be applied in this case.

The direct transfer is used in order to move funds between the marketplace and a seller.

The transfer object

The transfer object

{
    "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 10000,
    "currency": "EUR",
    "description": "Order #122",
    "type": "payment",
    "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
    "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
    "commission_amount:" 200,
    "on_hold": false,
    "payout": null,
    "additional_amount": 0,
    "reversed_amount": 0,
    "reversed_commission_amount": 0,
    "is_reversed": false,
    "reversals": []
}

Property Description
token string Unique identifier (ID) for the transfer object.
date_created string The creation date of transfer in ISO 8601 format.
amount integer The transfer amount in the smallest currency unit e.g in cents.
currency string Currency represented as three-letter ISO 4217 code.
description string A description of the transfer.
type string Indicates the type of transfer.

payment Indicates this is a split payment. The funds will be transferred from the payment to the seller’s account.

debit Indicates that funds will be transferred from the seller’s account to the marketplace.

credit Indicates that funds will be transferred from the marketplace to the seller’s account.
seller string The Seller ID the funds will be transferred from or to, depending on the type of the transfer.
payment string The Payment ID the funds are transferred from. This property is set only when the type property has the value payment.
commission_amount integer The commission amount held by the merchant’s marketplace.
on_hold boolean Whether the transfer payout is put on hold.
payout string The Payout ID in which the transfer has been included.
additional_amount integer The amount that was included in the transfer amount and taken directly from your balance.
reversed_amount integer The amount that has been reversed.
reversed_commission_amount integer The commission amount the has been reversed.
is_reversed boolean Indicates whether transfer has been fully reversed. If the transfer is only partially reversed, this attribute will still be false.
reversals list A list of reversals that have been applied to the transfer.

Create a payment transfer

Definition

POST https://api.everypay.gr/payments/{paymentId}/transfers

Example Request

$ curl https://api.everypay.gr/payments/pmt_lkPJrywRlDAp5oKrqOeRHEt0/transfers \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d seller=sel_U0FBPmz5t2zjDjKaOGABlo6A \
  -d amount=10000 \
  -d commission_amount=200 \
  -d description="Order #122"

Example Response

200 OK
{
    "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 10000,
    "currency": "EUR",
    "description": "Order #122",
    "type": "payment",
    "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
    "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
    "commission_amount:" 200,
    "on_hold": false,
    "payout": null,
    "additional_amount": 0,
    "reversed_amount": 0,
    "reversed_commission_amount": 0,
    "is_reversed": false,
    "reversals": []
}

You can split a payment after it has been successfully captured by providing the specific Payment ID.

If enabled in your marketplace account, you may transfer an amount that is greater than the remaining payment amount. To enable this feature, please contact our support team. The transfer method requires your account to have sufficient balance to process the transfer, and will fail in case of insufficient funds.

When splitting a payment the following limitations must be taken into consideration. In case any of those apply an error will be thrown.

Path Arguments  
paymentId required The unique Payment ID.
Body Arguments  
seller required The Seller ID that will be receiving the payment.
amount required The amount in cents the seller will receive.
commission_amount required The commission amount your marketplace will charge the seller.
description required The description of the transfer.
on_hold optional
0
Whether the funds will be processed for payout or not.
1 Funds will not be payout. In order to payout this transfer a second call is required.
0 Funds will be payout according to schedule.

Create a direct transfer

POST https://api.everypay.gr/sellers/{sellerId}/transfers

Example Request

$ curl https://api.everypay.gr/sellers/sel_U0FBPmz5t2zjDjKaOGABlo6A/transfers \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d type="debit" \
  -d amount=5000 \
  -d description="Monthly subscription fee - Inv. #345"

Example Response

200 OK
{
    "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 5000,
    "currency": "EUR",
    "description": "Monthly subscription fee - Inv. #345",
    "type": "debit",
    "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
    "payment": null,
    "commission_amount:" 0,
    "on_hold": false,
    "payout": null,
    "reversed_amount": 0,
    "reversed_commission_amount": 0,
    "is_reversed": false,
    "reversals": []
}

In order to enable specific business use-cases, you can direct transfer an amount, without linking any payments to it, from your account to a linked seller account or from a seller to your account provided a sufficient balance.

Please note that direct transfers are made with funds from the marketplace available balance amount and not from current balance amount.

Path Arguments  
sellerId required The unique Seller ID.
Body Arguments  
type required Specifies the type of the direct transfer.
debit Indicates that funds will be transferred from the seller’s account to the marketplace.
credit Indicates that funds will be transferred from the marketplace to the seller’s account.
amount required A positive integer in the smallest currency unit e.g in cents (e.g 10,99 EUR shall be converted to 1099).
description required A short description for the direct transfer reason.

Retrieve a transfer

Definition

GET https://api.everypay.gr/transfers/{transferId}

Example Request

$ curl https://api.everypay.gr/transfers/tra_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 10000,
    "currency": "EUR",
    "description": "Order #122",
    "type": "payment",
    "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
    "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
    "commission_amount:" 200,
    "on_hold": false,
    "payout": null,
    "additional_amount": 0,
    "reversed_amount": 0,
    "reversed_commission_amount": 0,
    "is_reversed": false,
    "reversals": []
}

Retrieves the details of a transfer. Provide the unique Transfer ID that was returned from the creation call.

Path Arguments  
transferId required The unique Transfer ID.

Update a transfer

Definition

PUT https://api.everypay.gr/transfers/{transferId}

Example Request

$ curl https://api.everypay.gr/transfers/tra_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d on_hold=0

Example Response

200 OK
{
    "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 10000,
    "currency": "EUR",
    "description": "Order #122",
    "type": "payment",
    "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
    "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
    "commission_amount:" 200,
    "on_hold": false,
    "payout": null,
    "additional_amount": 0,
    "reversed_amount": 0,
    "reversed_commission_amount": 0,
    "is_reversed": false,
    "reversals": []
}

Updates the details of a transfer. Provide the unique Transfer ID that was returned from the creation call. With regards to on_hold parameter the following limitations must be taken into consideration.

Path Arguments  
transferId required The unique Transfer ID.
Body Arguments  
description optional A description of the transfer reason.
on_hold optional Whether the funds will be processed for payout or not.
1 Funds will not be payout. In order to payout this transfer a second call is required.
0 Funds will be payout according to schedule.

List all transfers

Definition

GET https://api.everypay.gr/transfers

Example Request

$ curl https://api.everypay.gr/transfers?seller=sel_5i8KHSpex63i1cjLVfOMMhIa \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 52,
    "items": [
        {
            "token": "tra_lkPJrywRlDAp5oKrqOeRHEt0",
            "date_created": "2019-02-14T19:47:03+0200",
            "amount": 10000,
            "currency": "EUR",
            "description": "Order #122",
            "type": "payment",
            "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
            "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
            "commission_amount:" 200,
            "on_hold": false,
            "payout": null,
            "reversed_amount": 0,
            "reversed_commission_amount": 0,
            "is_reversed": false,
            "reversals": []
        },
        {
            "token": "tra_b7QO01Ie4csrDAkRjXijK7aM",
            "date_created": "2019-02-14T19:47:03+0200",
            "amount": 10000,
            "currency": "EUR",
            "description": "Order #123",
            "type": "payment",
            "seller": "sel_KJ53Qx3ZGaNLttUNxyB5JQO3",
            "payment": "pmt_U0FBPmz5t2zjDjKaOGABlo6A",
            "commission_amount:" 200,
            "on_hold": false,
            "payout": null,
            "reversed_amount": 10000,
            "reversed_commission_amount": 200,
            "is_reversed": true,
            "reversals": [
                {
                    "token": "rev_RobdUp58eeNzUQtOhaFHwxhi",
                    "date_created": "2019-02-14T19:47:03+0200",
                    "description": "Refund for Order #123",
                    "amount": 10000,
                    "commission_amount": 200,
                    "currency": "EUR",
                    "payout": null,
                    "transfer": "tra_b7QO01Ie4csrDAkRjXijK7aM"
                }
            ]
        },
        {...},
        {...},
        {...}
    ]
}

Returns a list of transfers. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
payment optional A Payment ID to list only transfers for provided payment.
seller optional A Seller ID to list only transfers for the provided seller.
payout optional A Payout ID to list only transfers for the provided payout.

Reversals

When funds transferred to a seller account needs to be reversed for reasons such as refund, adjustment, etc. you can initiate a reversal operation.

The reversal object

The reversal object

{
    "token": "rev_RobdUp58eeNzUQtOhaFHwxhi",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Refund for Order #122",
    "amount": 5000,
    "commission_amount": 100,
    "currency": "EUR",
    "payout": null,
    "transfer": "tra_b7QO01Ie4csrDAkRjXijK7aM"
}

Property Description
token string Unique identifier (ID) for the reversal object. Always starts with prefix rev_.
date_created string The creation date of reversal in ISO 8601 format.
amount integer The reversal amount in the smallest currency unit e.g in cents.
commission_amount integer The amount of the commission that has been reversed.
description string The reason of the reversal.
currency string Currency represented as three-letter ISO 4217 code.
payout string The Payout ID in which the reversal has been included.
transfer string The Transfer ID that has been reversed.

Create a reversal

Definition

POST https://api.everypay.gr/reversals

Example request with specified commission amount

$ curl https://api.everypay.gr/reversals \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d transfer=tra_lkPJrywRlDAp5oKrqOeRHEt0 \
  -d amount=5000 \
  -d description="Refund for order #122" \
  -d commission_amount=100

Example request with amount and auto refund commission

$ curl https://api.everypay.gr/reversals \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: \
  -d transfer=tra_lkPJrywRlDAp5oKrqOeRHEt0 \
  -d amount=5000 \
  -d description="Refund for order #122" \
  -d refund_commission=1

Example Response

200 OK
{
    "token": "rev_RobdUp58eeNzUQtOhaFHwxhi",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Refund for Order #122",
    "amount": 5000,
    "commission_amount": 100,
    "currency": "EUR",
    "payout": null,
    "transfer": "tra_b7QO01Ie4csrDAkRjXijK7aM"
}

When you create a new reversal, you must specify a transfer to create it on.

You can reverse fund transfers even after they have been payout, as long as there is a floating balance available in the seller account. You can initiate a partial reversal or reversal upto the amount originally transferred.

This method requires only the Transfer ID as parameter, and if you omit the amount parameter, a full reversal will be initiated including the commission amount. Once entirely reversed, a transfer can’t be reversed again. This method will return an error when called on an already-reversed transfer.

If you provide the commission_amount parameter then the refund_commission parameter will be ignored and the specified amount will be refunded to the seller. If the amount exceeds the remaining commission amount of the transfer an error will be thrown.

When creating a reversal for a direct transfer, the values of the properties commission_amount and refund_commission will be ignored.

Body Arguments  
transfer required The unique Transfer ID.
amount optional A positive integer in the smallest currency unit e.g in cents which represents the amount to be reversed. If no amount is specified then the entire amount of the transfer will be reversed.
description optional A description of the reversal.
commission_amount optional An integer representing the commission amount that will be refunded to the seller. Can be positive or zero.
refund_commission optional
1
Whether the commission amount should be refunded or not.
1 If a full transfer reversal is given, the full commission amount will be refunded. Otherwise the commission amount will be refunded with an amount proportional to the amount of the transfer reversed.
0 The commission will not be refunded to the seller.

Retrieve a reversal

Definition

GET https://api.everypay.gr/reversals/{reversalId}

Example Request

$ curl https://api.everypay.gr/reversals/rev_RobdUp58eeNzUQtOhaFHwxhi \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "rev_RobdUp58eeNzUQtOhaFHwxhi",
    "date_created": "2019-02-14T19:47:03+0200",
    "description": "Refund for Order #122",
    "amount": 5000,
    "commission_amount": 100,
    "currency": "EUR",
    "payout": null,
    "transfer": "tra_b7QO01Ie4csrDAkRjXijK7aM"
}

Retrieves the details of a reversal. Provide the unique Transfer ID that was returned from the creation call.

Path Arguments  
reversalId required The unique Reversal ID.

List all reversals

Definition

GET https://api.everypay.gr/reversals

Example Request

$ curl https://api.everypay.gr/reversals \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 21,
    "items": [
        {
            "token": "rev_RobdUp58eeNzUQtOhaFHwxhi",
            "date_created": "2019-02-14T19:47:03+0200",
            "description": "Refund for Order #122",
            "amount": 5000,
            "commission_amount": 100,
            "currency": "EUR",
            "payout": null,
            "transfer": "tra_b7QO01Ie4csrDAkRjXijK7aM"
        },
        {...},
        {...},
        {...}
    ]
}

Returns a list of reversals. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
transfer optional A Transfer ID to list only reversals for the provided transfer.
payout optional A Payout ID to list only reversals for the provided payout.

Payouts

A Payout object is created after a seller starts receiving funds to his account. Payouts are created according to a seller’s schedule which can be defined upon seller creation. By default, your marketplace account is configured to send payouts daily to all eligible seller accounts.

When a payout is created its status will be Pending until it is deposited to the seller’s bank account. After the payout has been sucessfully deposited its status will be marked as Deposited.

The payout object

The payout object

{
    "token": "pay_34FK1pZM8OewGcK1kfIRpN9F",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 9200,
    "currency": "EUR",
    "status": "Pending",
    "is_deposited": false,
    "date_deposited": null,
    "seller": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
    "bank_account": {
        "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
        "date_created": "2019-02-14T17:50:09+0200",
        "iban": "GR6501101100000011047025496",
        "bank_name": "NATIONAL BANK OF GREECE S.A.",
        "beneficiary_name": "John Doe",
        "is_default": true
    },
    "statement_description": null,
    "transfer_amount": 10000,
    "reversal_amount": 0,
    "commission_amount": 800,
    "reversed_commission_amount": 0,
    "transfer_count": 2,
    "reversal_count": 0
}

Property Description
token string Unique identifier (ID) for the payout object. Always starts with the prefix pay_.
date_created string The creation date of the payout in ISO 8601 format.
amount integer The amount of the payout in the smallest currency unit e.g in cents that will be deposited on seller’s bank account.
currency string Currency represented as three-letter ISO 4217 code.
status string Indicates the payout’s status.
Pending Payout has not been submitted yet to the seller’s bank account.
Deposited Payout has been successfully deposited to seller’s bank account
is_deposited boolean Indicates whether the payout amount has been deposited to seller’s bank account.
date_deposited string The deposit date of the payout in ISO 8601 format.
seller string The Seller ID associated with the payout.
bank_account object An object containing the details of the seller’s bank account.
statement_description string This description will be displayed on the seller’s bank statement.
transfer_amount integer A positive integer indicating the total transfer amount of the payout.
reversal_amount integer A positive integer indicating the total amount of reversals.
commission_amount integer A positive integer indicating the total commission amount of the marketplace that will be deducted from the total transfer amount.
reversed_commission_amount integer A positive integer indicating the total commission amount that was refunded to the seller.
transfer_count integer The total number of transfers included in the payout.
reversal_count integer The total number of reversals included in the payout.

Retrieve a payout

Definition

GET https://api.everypay.gr/payouts/{payoutId}

Example Request

$ curl https://api.everypay.gr/payouts/pay_34FK1pZM8OewGcK1kfIRpN9F \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "token": "pay_34FK1pZM8OewGcK1kfIRpN9F",
    "date_created": "2019-02-14T19:47:03+0200",
    "amount": 9200,
    "currency": "EUR",
    "status": "Pending",
    "is_deposited": false,
    "date_deposited": null,
    "seller": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
    "bank_account": {
        "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
        "date_created": "2019-02-14T17:50:09+0200",
        "iban": "GR6501101100000011047025496",
        "bank_name": "NATIONAL BANK OF GREECE S.A.",
        "beneficiary_name": "John Doe",
        "is_default": true
    },
    "statement_description": null,
    "transfer_amount": 10000,
    "reversal_amount": 0,
    "commission_amount": 800,
    "reversed_commission_amount": 0,
    "transfer_count": 2,
    "reversal_count": 0
}

Retrieves the details of a payout.

Path Arguments  
payoutId required The unique Payout ID.

List all payouts

Definition

GET https://api.everypay.gr/payouts

Example Request

$ curl https://api.everypay.gr/payouts?seller=sel_lkPJrywRlDAp5oKrqOeRHEt0 \
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:

Example Response

200 OK
{
    "total_count": 23,
    "items": [
        {
            "token": "pay_34FK1pZM8OewGcK1kfIRpN9F",
            "date_created": "2019-02-14T19:47:03+0200",
            "amount": 9200,
            "currency": "EUR",
            "status": "Pending",
            "is_deposited": false,
            "date_deposited": null,
            "seller": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
            "bank_account": {
                "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
                "date_created": "2019-02-14T17:50:09+0200",
                "iban": "GR6501101100000011047025496",
                "bank_name": "NATIONAL BANK OF GREECE S.A.",
                "beneficiary_name": "John Doe",
                "is_default": true
            },
            "statement_description": null,
            "transfer_amount": 10000,
            "reversal_amount": 0,
            "commission_amount": 800,
            "reversed_commission_amount": 0,
            "transfer_count": 2,
            "reversal_count": 0
        },
        {
            "token": "pay_31Pa27qIdAMp00May0GDi28M",
            "date_created": "2019-02-14T19:47:03+0200",
            "amount": 18900,
            "currency": "EUR",
            "status": "Deposited",
            "is_deposited": true,
            "date_deposited": "2019-02-15T19:47:03+0200",
            "seller": "sel_lkPJrywRlDAp5oKrqOeRHEt0",
            "bank_account": {
                "token": "bnk_pvLDfMPn8gtcYjHuuMIbV5p5",
                "date_created": "2019-02-14T17:50:09+0200",
                "iban": "GR6501101100000011047025496",
                "bank_name": "NATIONAL BANK OF GREECE S.A.",
                "beneficiary_name": "John Doe",
                "is_default": true
            },
            "statement_description": "MARKETPLACE IDENTIFIER",
            "transfer_amount": 26000,
            "reversal_amount": 6500,
            "commission_amount": 800,
            "reversed_commission_amount": 200,
            "transfer_count": 4,
            "reversal_count": 1
        },
        {...},
        {...}
    ]
}

Returns a list of payouts. You can use the below parameters to limit the results and paginate through the list.

Query Arguments  
count optional
10
20
The number of records to return back in response. Limit can range between 1 and 20.
offset optional
0
The number of records to skip before adding results to the response.
date_from optional Provide a date from in YYYY-MM-DD format.
date_to optional Provide a date to in YYYY-MM-DD format.
seller optional A Seller ID to list only payouts for the provided seller.
is_deposited optional Filter payouts by deposit status.
1 Returns only payouts that have been deposited.
0 Returns payouts that are pending for deposit.
Data Structures

Card arguments

Arguments  
card_number required Card number without any separators.
expiration_year required Card expiration year (4 digits).
expiration_month required Card expiration month (2 digits).
holder_name required Cardholder’s name.
cvv required The 3 or 4 digits security code of the card.