Skip to main content
POST
/
bookings
/
{bookingId}
/
external-transaction
cURL
curl --request POST \
  --url https://api-alpha.fourvenues.com/integrations/bookings/{bookingId}/external-transaction \
  --header 'Content-Type: application/json' \
  --header 'integration_id: <api-key>' \
  --header 'secret: <api-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "transaction_type": "payment",
  "amount": 50,
  "method": "cash",
  "payment_method_slug": "visa",
  "description": "External payment"
}
'
{
  "success": true,
  "data": {
    "_id": "ld9o8tpo7tyld79qxdk6sgikl5i4xjpj",
    "booking_id": "gxwts76a2qpoxf2rdtxy35etfk6xyd1m",
    "transaction_type": "payment",
    "amount": 50,
    "currency": "EUR",
    "method": "cash",
    "payment_method_slug": "visa",
    "description": "External payment",
    "original_external_payment_id": null
  }
}

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)

Path Parameters

​
bookingId
string
required

Id of the booking

Body

application/json

Body of the request

​
transaction_type
enum<string>
required
Available options:
payment
Example:

"payment"

​
amount
number
required
Example:

50

​
method
enum<string>
required
Available options:
transfer,
cash,
external-card,
external-online,
check,
other
Example:

"cash"

​
payment_method_slug
enum<string>
Available options:
visa,
mastercard,
amex
Example:

"visa"

​
description
string
Example:

"External payment"

Response

HTTP OK

​
success
boolean
Example:

true

​
data
object