GET
/
payment-services
/
{payment_service_id}
This endpoint requires the payment-services.read scope.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The ID of the payment service.
An active, configured payment service.
The type of this resource.
Available options:
payment-service
The ID of this payment service.
Required string length: 1 - 200
A list of countries for which this service is enabled, in ISO two-letter
code format.
A list of currencies for which this service is enabled, in ISO 4217
three-letter code format.
Defines if this service is currently active or not.
The date and time when this service was created.
The custom name set for this service.
Required string length: 1 - 200
A list of fields, each containing a key-value pair for each field
configured for this payment service. Fields marked as secret
(see Payment Service Definition) are not returned.
Required string length: 1 - 50
Required string length: 1 - 5000
A list of fields, each containing a key-value pair for each field
configured for reporting for this payment service. Fields marked as
secret (see Payment Service Definition) are not returned.
Required string length: 1 - 50
Required string length: 1 - 5000
The unique ID for a merchant account.
An object containing a key for each supported card scheme (Amex,
Discover, Mastercard and Visa), and for each key an object with
the merchant profile for this service and the corresponding scheme.
Merchant profile for Amex.
merchant_profile.amex. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.amex. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.amex. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.amex. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.amex. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.amex. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.amex. created_at
The date and time when this profile was created.
Merchant profile for Dankort.
merchant_profile.dankort. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.dankort. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.dankort. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.dankort. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.dankort. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.dankort. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.dankort. created_at
The date and time when this profile was created.
merchant_profile. discover
Merchant profile for Discover.
merchant_profile.discover. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.discover. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.discover. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.discover. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.discover. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.discover. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.discover. created_at
The date and time when this profile was created.
Merchant profile for JCB.
merchant_profile.jcb. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.jcb. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.jcb. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.jcb. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.jcb. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.jcb. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.jcb. created_at
The date and time when this profile was created.
merchant_profile. mastercard
Merchant profile for Mastercard.
merchant_profile.mastercard. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.mastercard. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.mastercard. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.mastercard. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.mastercard. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.mastercard. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.mastercard. created_at
The date and time when this profile was created.
merchant_profile. unionpay
Merchant profile for UnionPay.
merchant_profile.unionpay. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.unionpay. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.unionpay. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.unionpay. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.unionpay. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.unionpay. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.unionpay. created_at
The date and time when this profile was created.
Merchant profile for Visa.
merchant_profile.visa. merchant_acquirer_bin
Acquirer bin to use when calling 3DS through this scheme.
Maximum length: 11
merchant_profile.visa. merchant_url
URL to send when calling 3DS through this scheme.
merchant_profile.visa. merchant_acquirer_id
Merchant ID to use when calling 3DS through this scheme.
Maximum length: 35
merchant_profile.visa. merchant_name
Merchant name to use when calling 3DS through this scheme.
Maximum length: 40
merchant_profile.visa. merchant_country_code
Merchant country code to use when calling 3DS through this scheme.
Required string length: 3
merchant_profile.visa. merchant_category_code
Merchant category code to use when calling 3DS through this scheme.
Maximum length: 4
merchant_profile.visa. created_at
The date and time when this profile was created.
The payment method that this service handles.
Available options:
afterpay,
alipay,
alipayhk,
applepay,
bacs,
bancontact,
banked,
becs,
bitpay,
boleto,
boost,
card,
cashapp,
chaseorbital,
checkout-session,
clearpay,
click-to-pay,
dana,
dcb,
dlocal,
ebanx,
eps,
everydaypay,
gcash,
giropay,
givingblock,
gocardless,
googlepay,
googlepay_pan_only,
gopay,
grabpay,
id,
ideal,
kakaopay,
kcp,
klarna,
laybuy,
linepay,
linkaja,
maybankqrpay,
multibanco,
multipago,
network-token,
oney_3x,
oney_4x,
oney_6x,
oney_10x,
oney_12x,
ovo,
oxxo,
payid,
paymaya,
paypal,
paypalpaylater,
payto,
venmo,
pix,
rabbitlinepay,
razorpay,
scalapay,
sepa,
shopeepay,
singteldash,
smartpay,
sofort,
spei,
stripedd,
thaiqr,
touchngo,
truemoney,
trustly,
trustlyeurope,
vipps,
waave,
wechat,
zippay
Defines if network tokens are enabled for the service. This feature
can only be enabled if the payment service is set as open_loop and
the PSP is set up to accept network tokens.
Defines if the service works as an open-loop service. This feature
can only be enabled if the PSP is set up to accept previous scheme
transaction IDs.
Defines if tokenization is enabled for the service. This feature
can only be enabled if the payment service is NOT set as open_loop
and the PSP is set up to tokenize.
The ID of the payment service definition used to create this service.
Required string length: 1 - 50
Defines if settlement reporting is enabled for the service.
This feature can only be enabled if the payment service
definition supports the settlement_reporting feature.
The current status of this service. This will start off as pending, move
to created, and might eventually move to an error status if and when the
credentials are no longer valid.
Available options:
pending,
created,
failed
Defines if 3-D Secure is enabled for the service. This feature
can only be enabled if the payment service definition supports
the three_d_secure_hosted feature.
This does not affect pass through 3-D Secure data.
The date and time when this service was last updated.
The URL that needs to be configured with this payment service as the
receiving endpoint for webhooks from the service to Gr4vy. Currently,
Gr4vy does not yet automatically register webhooks on setup, and
therefore webhooks need to be registered manually by the merchant.
