Get payments

GET

payments

curl --request GET \
  --url https://api-alpha.fourvenues.com/integrations/payments/ \
  --header 'integration_id: <api-key>' \
  --header 'secret: <api-key>' \
  --header 'x-api-key: <api-key>'

{
  "success": true,
  "data": [
    {
      "venue_id": "fJ0vphh0acfytM4yWdAAXZcNPwDRDFpq",
      "venue_slug": "pacha",
      "type_id": "TCDu2yVBgwCHbBfHZH56HVdzn2vYcjcn",
      "type_slug": "general-admission",
      "event_id": "xhL6F5eYyeLvc40E2MKmnBQZYf2nU7zT",
      "event_slug": "saturday-night-26-09-2022",
      "event_date": "2022-09-26",
      "channel_id": "6RKUYneVbpbx6g4uBh8QgAe9xrrZq2mb",
      "channel_slug": "my-channel",
      "user_id": "ueC9A79zeLHMaNSY1hLw94zLu3knNhHT",
      "artists": [
        "david-guetta",
        "martin-garrix"
      ],
      "day": 26,
      "month": 9,
      "year": 2022,
      "at": "2022-09-15T23:00:00.000Z",
      "resource_type": "tickets",
      "n_resources": 2,
      "resources_ids": [
        "ANShQaGXdrYpiDVNAqdzX2u7u6yQBKvf",
        "GYnAwwrBX7ATNWX9tiXQbHZ4720uUjKQ"
      ],
      "total_amount": 20,
      "total_fees": 2,
      "total_warranty": 1,
      "total_discount": 0,
      "refunded": 0,
      "payment_method": "card",
      "issuer_country": "ES",
      "shopper_country": "ES",
      "method_last4": "1234",
      "method_alias": "visa",
      "sale_type": "online",
      "client_name": "John Appleseed",
      "client_birthdate": "1990-01-01",
      "client_email": "john.appleseed@fourvenues.com",
      "client_phone": "+34612345789",
      "invoice_references": [
        {
          "invoice_reference": "EV24T-TOX2-0000215",
          "resource_id": "ANShQaGXdrYpiDVNAqdzX2u7u6yQBKvf"
        }
      ]
    }
  ]
}

Authorizations

integration_id

string

header

required

Identifier of the integration (Auth v1)

secret

string

header

required

Secret of the organization (Auth v1)

x-api-key

string

header

required

API key (Auth v2)

Query Parameters

event_id

string

Event identifier.

start_date

string

Start date for the range.

end_date

string

End date for the range.

limit

string

Limit of results.

offset

string

Offset of results.

Response

200

application/json

HTTP OK

success

boolean

Example:

true

data

object[]

Array of Payments

data.venue_id

string

Venue identifier.

Example:

"fJ0vphh0acfytM4yWdAAXZcNPwDRDFpq"

data.venue_slug

string

Venue slug.

Example:

"pacha"

data.type_id

string

Type identifier.

Example:

"TCDu2yVBgwCHbBfHZH56HVdzn2vYcjcn"

data.type_slug

string

Type slug.

Example:

"general-admission"

data.event_id

string

Event identifier.

Example:

"xhL6F5eYyeLvc40E2MKmnBQZYf2nU7zT"

data.event_slug

string

Event slug.

Example:

"saturday-night-26-09-2022"

data.event_date

string

Event date.

Example:

"2022-09-26"

data.channel_id

string

Channel identifier.

Example:

"6RKUYneVbpbx6g4uBh8QgAe9xrrZq2mb"

data.channel_slug

string

Channel slug.

Example:

"my-channel"

data.user_id

string

User identifier.

Example:

"ueC9A79zeLHMaNSY1hLw94zLu3knNhHT"

data.artists

string[]

Artists of the event.

Example:

["david-guetta", "martin-garrix"]

data.day

number

Day of sale.

Example:

26

data.month

number

Month of sale.

Example:

9

data.year

number

Year of sale.

Example:

2022

data.at

string

Date of the payment.

Example:

"2022-09-15T23:00:00.000Z"

data.resource_type

string

Resource type.

Example:

"tickets"

data.n_resources

number

Number of resources.

Example:

2

data.resources_ids

string[]

Resources identifiers.

Example:

[
  "ANShQaGXdrYpiDVNAqdzX2u7u6yQBKvf",
  "GYnAwwrBX7ATNWX9tiXQbHZ4720uUjKQ"
]

data.total_amount

number

Total amount.

Example:

20

data.total_fees

number

Total fees.

Example:

2

data.total_warranty

number

Total warranty.

Example:

1

data.total_discount

number

Total discount.

Example:

0

data.refunded

number

Refunded amount.

Example:

0

data.payment_method

string

Payment method.

Example:

"card"

data.issuer_country

string

Issuer country.

Example:

"ES"

data.shopper_country

string

Shopper country.

Example:

"ES"

data.method_last4

string

Last 4 digits of the payment method.

Example:

"1234"

data.method_alias

string

Alias of the payment method.

Example:

"visa"

data.sale_type

string

Sale type.

Example:

"online"

data.client_name

string

Client name.

Example:

"John Appleseed"

data.client_birthdate

string

Client birthdate.

Example:

"1990-01-01"

data.client_email

string

Client email.

Example:

"john.appleseed@fourvenues.com"

data.client_phone

string

Client phone.

Example:

"+34612345789"

data.invoice_references

object[]

Invoice references

Get users Get refunds

curl --request GET \
  --url https://api-alpha.fourvenues.com/integrations/payments/ \
  --header 'integration_id: <api-key>' \
  --header 'secret: <api-key>' \
  --header 'x-api-key: <api-key>'

{
  "success": true,
  "data": [
    {
      "venue_id": "fJ0vphh0acfytM4yWdAAXZcNPwDRDFpq",
      "venue_slug": "pacha",
      "type_id": "TCDu2yVBgwCHbBfHZH56HVdzn2vYcjcn",
      "type_slug": "general-admission",
      "event_id": "xhL6F5eYyeLvc40E2MKmnBQZYf2nU7zT",
      "event_slug": "saturday-night-26-09-2022",
      "event_date": "2022-09-26",
      "channel_id": "6RKUYneVbpbx6g4uBh8QgAe9xrrZq2mb",
      "channel_slug": "my-channel",
      "user_id": "ueC9A79zeLHMaNSY1hLw94zLu3knNhHT",
      "artists": [
        "david-guetta",
        "martin-garrix"
      ],
      "day": 26,
      "month": 9,
      "year": 2022,
      "at": "2022-09-15T23:00:00.000Z",
      "resource_type": "tickets",
      "n_resources": 2,
      "resources_ids": [
        "ANShQaGXdrYpiDVNAqdzX2u7u6yQBKvf",
        "GYnAwwrBX7ATNWX9tiXQbHZ4720uUjKQ"
      ],
      "total_amount": 20,
      "total_fees": 2,
      "total_warranty": 1,
      "total_discount": 0,
      "refunded": 0,
      "payment_method": "card",
      "issuer_country": "ES",
      "shopper_country": "ES",
      "method_last4": "1234",
      "method_alias": "visa",
      "sale_type": "online",
      "client_name": "John Appleseed",
      "client_birthdate": "1990-01-01",
      "client_email": "john.appleseed@fourvenues.com",
      "client_phone": "+34612345789",
      "invoice_references": [
        {
          "invoice_reference": "EV24T-TOX2-0000215",
          "resource_id": "ANShQaGXdrYpiDVNAqdzX2u7u6yQBKvf"
        }
      ]
    }
  ]
}

Introduction

API Reference

Recipes

Authorizations

Query Parameters

Response