Introduction
Transactions
Buyers
Checkout Sessions
Payment links
Payment options
Refunds
Instruments
- Card schemes
- Card details
- Digital wallets
- Gift cards
- Payment methods
- Payment method definitions
Vault
- Account updater
- Network tokens
- Payment service tokens
- Vault Forward
- Vault Forward endpoints
- Vault Forward authentication
Connections
- All services
- Payment services
- Digital wallets
- Anti-fraud services
Other
- Flow
- Reports
- Report executions
- Webhook subscriptions
Get a payment service definition
Get the definition of a payment service that can be configured.
GET
/
payment-service-definitions
/
{payment_service_definition_id}
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
var res = await sdk.PaymentServiceDefinitions.GetAsync(paymentServiceDefinitionId: "adyen-ideal");
// handle response
Copy
Ask AI
{
"id": "adyen-ideal",
"type": "payment-service-definition",
"display_name": "iDEAL",
"method": "ideal",
"fields": [
{
"key": "private_api_key",
"display_name": "Private API key",
"required": true,
"format": "text",
"secret": true
}
],
"reporting_fields": [
{
"key": "private_api_key",
"display_name": "Private API key",
"required": true,
"format": "text",
"secret": true
}
],
"supported_currencies": [
"USD",
"GBP",
"EUR",
"AUD"
],
"supported_countries": "US",
"mode": "card",
"icon_url": "https://example.com/icons/adyen-ideal.svg",
"supported_features": {},
"required_checkout_fields": [
{
"required_fields": [
"address.line1",
"address.country",
"address.city",
"address.postal_code"
],
"conditions": {
"country": [
"IN"
]
}
}
],
"configuration": {
"approval_ui_target": "any",
"approval_ui_height": "100px",
"approval_ui_width": "100px",
"cart_items_limit": 100,
"cart_items_required": true,
"cart_items_should_match_amount": true
}
}
This endpoint requires the payment-service-definitions.read
scope.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Examples:
"adyen-ideal"
Response
200
application/json
Successful Response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
var res = await sdk.PaymentServiceDefinitions.GetAsync(paymentServiceDefinitionId: "adyen-ideal");
// handle response
Copy
Ask AI
{
"id": "adyen-ideal",
"type": "payment-service-definition",
"display_name": "iDEAL",
"method": "ideal",
"fields": [
{
"key": "private_api_key",
"display_name": "Private API key",
"required": true,
"format": "text",
"secret": true
}
],
"reporting_fields": [
{
"key": "private_api_key",
"display_name": "Private API key",
"required": true,
"format": "text",
"secret": true
}
],
"supported_currencies": [
"USD",
"GBP",
"EUR",
"AUD"
],
"supported_countries": "US",
"mode": "card",
"icon_url": "https://example.com/icons/adyen-ideal.svg",
"supported_features": {},
"required_checkout_fields": [
{
"required_fields": [
"address.line1",
"address.country",
"address.city",
"address.postal_code"
],
"conditions": {
"country": [
"IN"
]
}
}
],
"configuration": {
"approval_ui_target": "any",
"approval_ui_height": "100px",
"approval_ui_width": "100px",
"cart_items_limit": 100,
"cart_items_required": true,
"cart_items_should_match_amount": true
}
}
Assistant
Responses are generated using AI and may contain mistakes.