GET
/
payment-service-definitions
/
{payment_service_definition_id}
curl --request GET \
  --url https://api.{gr4vy_id}.gr4vy.app/payment-service-definitions/{payment_service_definition_id} \
  --header 'Authorization: Bearer <token>'
{
  "configuration": {
    "approval_ui_height": "300px",
    "approval_ui_target": "any",
    "approval_ui_width": "300px"
  },
  "display_name": "Stripe",
  "fields": [
    {
      "display_name": "Private API key",
      "format": "text",
      "key": "private_api_key",
      "required": true,
      "secret": true
    }
  ],
  "icon_url": "https://cdn.gr4vy.app/stripe.svg",
  "id": "stripe-card",
  "method": "card",
  "mode": "card",
  "supported_countries": [
    "US",
    "GB",
    "DE"
  ],
  "supported_currencies": [
    "USD",
    "GBP",
    "EUR"
  ],
  "supported_features": {
    "delayed_capture": true,
    "digital_wallets": true,
    "network_tokens_default": true,
    "network_tokens_toggle": true,
    "open_loop": true,
    "open_loop_toggle": true,
    "partial_refunds": true,
    "payment_method_tokenization": true,
    "payment_method_tokenization_toggle": true,
    "refunds": true,
    "requires_webhook_setup": true,
    "three_d_secure_hosted": true,
    "three_d_secure_pass_through": true,
    "verify_credentials": true,
    "void": true
  },
  "type": "payment-service-definition"
}

This endpoint requires the payment-service-definitions.read scope.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

payment_service_definition_id
string
required

The unique ID of the payment service definition.

Response

200 - application/json
configuration
object

Configuration items for the payment service.

display_name
string

The display name of this service.

fields
object[]

A list of fields that need to be submitted when activating the payment. service.

icon_url
string | null

An icon to display for the payment service.

id
string

The ID of the payment service. This is the underlying provider followed by a dash followed by the payment method ID.

method
enum<string>

The ID of the payment method that this services handles.

Available options:
afterpay,
alipay,
alipayhk,
applepay,
bacs,
bancontact,
banked,
becs,
bitpay,
boleto,
boost,
card,
checkout-session,
click-to-pay,
clearpay,
dana,
dcb,
eps,
fortumo,
gcash,
giropay,
gocardless,
googlepay,
gopay,
grabpay,
ideal,
id,
kakaopay,
klarna,
laybuy,
linepay,
linkaja,
maybankqrpay,
multibanco,
oney_3x,
oney_4x,
oney_6x,
oney_10x,
oney_12x,
ovo,
oxxo,
paymaya,
paypal,
paypalpaylater,
pix,
rabbitlinepay,
razorpay,
scalapay,
sepa,
shopeepay,
singteldash,
sofort,
stripedd,
thaiqr,
touchngo,
truemoney,
trustly,
venmo,
waave,
wechat,
zippay
mode
enum<string>

The mode of this payment service.

Available options:
card,
redirect,
applepay,
googlepay
supported_countries
string[]

A list of two-letter ISO country codes that this service supports.

supported_currencies
string[]

A list of three-letter ISO currency codes that this service supports.

supported_features
object

Features supported by the payment definition.

type
enum<string>
default: payment-service-definition

payment-service-definition.

Available options:
payment-service-definition

Was this page helpful?