Skip to main content
POST
/
barbers
/
{barberId}
/
appointments
/
{appointmentId}
/
payments
/
external
Create external payment for appointment
curl --request POST \
  --url https://api.guile.app/barbers/{barberId}/appointments/{appointmentId}/payments/external \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "456.78",
  "paymentToken": "<string>",
  "notes": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "paymentMethod": "platform",
  "paymentDirection": "payment",
  "paymentState": "pending",
  "amount": "456.78",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "paymentToken": "<string>",
  "externalId": "<string>",
  "originalPaymentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "refundReason": "<string>"
}

Headers

ā€‹
Idempotency-Key
string
required

A client-generated idempotency key to ensure operations are only processed once even if a client retries the operation. The V4 UUID format, as defined in RFC 4122, is recommended to avoid collisions but is not required.

Path Parameters

ā€‹
barberId
string<uuid>
required

The unique, opaque system identifier for a resource. This case-sensitive ID is also used as path parameters in URLs or in other properties or parameters that reference a resource by ID rather than URL.

ā€‹
appointmentId
string<uuid>
required

The unique, opaque system identifier for a resource. This case-sensitive ID is also used as path parameters in URLs or in other properties or parameters that reference a resource by ID rather than URL.

Body

application/json

Request body for creating an external payment.

ā€‹
amount
string<decimal>
required

The amount of the external payment.

Example:

"456.78"

ā€‹
paymentToken
string

Optional external payment token or reference (e.g., Venmo transaction ID).

Maximum string length: 255
ā€‹
notes
string

Optional notes about the external payment.

Maximum string length: 500

Response

Created.

Represents a payment associated with an appointment.

ā€‹
id
string<uuid>
required

Unique identifier for the payment.

ā€‹
paymentMethod
enum<string>
required

The method used to process this payment.

Available options:
platform,
external
ā€‹
paymentDirection
enum<string>
required

The direction of the payment flow.

Available options:
payment,
refund
ā€‹
paymentState
enum<string>
required

The payment state.

Available options:
pending,
authorized,
paid,
failed
ā€‹
amount
string<decimal>
required

The amount of this payment.

Example:

"456.78"

ā€‹
createdAt
string<date-time>
required

The date-time when this resource was created, in RFC 3339 date-time YYYY-MM-DDThh:mm:ss.sssZ format, UTC. This is derived and immutable.

ā€‹
updatedAt
string<date-time>
required

The date-time when this resource was updated, in RFC 3339 date-time YYYY-MM-DDThh:mm:ss.sssZ format, UTC. This is derived and immutable.

ā€‹
paymentToken
string

For external payments, the token representing the payment.

ā€‹
externalId
string

External identifier for the payment from the payment processor or external system.

ā€‹
originalPaymentId
string<uuid>

For refund payments, the original payment being refunded.

ā€‹
refundReason
string

For refund payments, the reason for the refund.

Maximum string length: 500