REST Objects Payment Provider

5.0.0 5.9.4

The Payment Provider object is part of the overall ServiceBroker Configuration object, in the following location:

Configuration > Providers > Payment Provider

A Payment Provider object is used within the context of a REST Objects Providers (itself part of an REST Objects Configuration) to represent the details of how ServiceBroker is to be integrated with a payment provider for the relevant tenant.

On this page:

Related pages:

Payment Provider Object Format - authorize.net

JSON Format

{
    "Provider": "AuthorizeNet",
    "Features": {
        "RequestPayment": {
            "HostedPaymentSettings": {
                "hostedPaymentReturnOptions": {
                    "showReceipt": false
                },
                "hostedPaymentButtonOptions": {
                    "text": "Pay"
                },
                "hostedPaymentStyleOptions": {
                    "bgColor": "#2185c7"
                },
                "hostedPaymentPaymentOptions": {
                    "cardCodeRequired": true,
                    "showCreditCard": true,
                    "showBankAccount": false
                },
                "hostedPaymentSecurityOptions": {
                    "captcha": true
                },
                "hostedPaymentShippingAddressOptions": {
                    "show": true,
                    "required": false
                },
                "hostedPaymentBillingAddressOptions": {
                    "show": false,
                    "required": false
                },
                "hostedPaymentCustomerOptions": {
                    "showEmail": true,
                    "requiredEmail": false,
                    "addPaymentProfile": false
                },
                "hostedPaymentOrderOptions": {
                    "show": false
                },
                "hostedPaymentIFrameCommunicatorUrl": {
                    "url": ""
                }
            }
        },
        "ConfirmPayment": {
        }
    },
	"SecretKey": "",
	"MerchantAuthentication": {
    	"Name": "",
        "TransactionKey": ""
    },
    "BaseUrl": ""
}

Payment Provider Object Properties - authorize.net

Property					Type	Required?	Description
`Provider`					`string`	Yes	The name of the payment provider, which is `AuthorizeNet` in this case.
`Features`					`object`	Yes	An object that contains the payment features supported by the provider. In this case, the provider supports `RequestPayment` and `ConfirmPayment` features.
	`RequestPayment`				`object`	Yes	Object defining the endpoint and parameters to be passed to authorize.net when initializing payments.
		`HostedPaymentSettings`			`object`	Yes	An object that contains the settings for the hosted payment form.
			`hostedPaymentReturnOptions`		`object`	Yes	An object that specifies whether to show a receipt after the payment is completed.
				`showReceipt`	`boolean`	Yes	This confirms that a recipt is needed.
			`hostedPaymentButtonOptions`		`object`	Yes	An object that specifies the text to display on the payment button.
				`text`	`string`	Yes	The text saved for display
			`hostedPaymentStyleOptions`		`object`	Yes	An object that specifies the background color of the payment form.
				`bgColor`	`string`	Yes	The color used.
			`hostedPaymentPaymentOptions`		`object`	Yes	An object that specifies whether to show the credit card and bank account fields, and whether to require the card code.
				`cardCodeRequired`	`boolean`	Yes	Saves if the credit code required.
				`showCreditCard`	`boolean`	Yes	Saves if the credit card should be shown.
				`showBankAccount`	`boolean`	Yes	Saves if the bank account should be shown.
			`hostedPaymentSecurityOptions`		`object`	Yes	An object that specifies whether to use a CAPTCHA to prevent fraud.
				`captcha`	`boolean`	Yes	Shows that the use successfull used captcha.
			`hostedPaymentShippingAddressOptions`		`object`	Yes	An object that specifies whether to show the shipping address fields, and whether they are required.
				`show`	`boolean`	Yes	Marks if the shipping address fields should be shown.
				`required`	`boolean`	Yes	Marks if the shipping address fields are required.
			`hostedPaymentBillingAddressOptions`		`object`	Yes	An object that specifies whether to show the billing address fields, and whether they are required.
				`show`	`boolean`	Yes	Marks if the billing address fields should be shown.
				`required`	`boolean`	Yes	Marks if the billing address fields are required.
			`hostedPaymentCustomerOptions`		`object`	Yes	An object that specifies whether to show the customer email field, and whether it is required..
				`showEmail`	`boolean`	Yes	Saves information about if the email should be shown.
				`requiredEmail`	`boolean`	Yes	Saves information about the email.
			`hostedPaymentOrderOptions`		`object`	Yes	An object that specifies whether to show the order summary..
				`show`	`boolean`	Yes	Shows that above is required or not/
			`hostedPaymentIFrameCommunicatorUrl`		`object`	Yes	An object that specifies the URL of the iframe communicator used to communicate between the payment form and the application.
				`url`	`string`	Yes	The saved URL
	`ConfirmPayment`				`object`	Yes	Empty object.
`SecretKey`					`string`	Yes	A secret key used to authenticate requests to the Authorize.Net API.
`MerchantAuthentication`					`object`	Yes	An object that contains the merchant's authentication information, including the merchant name and transaction key.
	`Name`				`string`	Yes	The name of the merchant.
	`TransactionKey`				`string`	Yes	The transaction key assigned to the merchant.
`BaseUrl`					`string`	Yes	The base URL of the payment provider. Currently, only https://www.chasepaymentechhostedpay-var.com is supported.

Payment Provider Object Format - Chase Payment

Unable to render {include} The included page could not be found.

Payment Provider Object Properties - Chase Payment

Property				Type	Required?	Description
`Provider`				`string`	Yes	The payment provider to use. For Chase Payment, the value is: `ChasePayment`.
`Features`				`object`	Yes	An object to be passed to the payment provider when requesting payments. The object contains placeholder variables, defined as `{variables}` which will be replaced by the corresponding values from the `Props` object below.
	`RequestPayment`			`object`	Yes	Object defining the endpoint and parameters to be passed to Chase when initializing payments.
		`InitParams`		`object`	Yes	Chase-defined parameters to be passed when initializing payments.
			`hostedSecureID`	`string`	Yes	Variable: `{HostedSecureId}` When sent to Chase, will be replaced by the value of the `Props > HostedSecureId` value.
			`hostedSecureAPIToken`	`string`	Yes	Variable: `{HostedSecureApiToken}` When sent to Chase, will be replaced by the value of the `Props > HostedSecureApiToken` value.
			`css_url`	`string`	Yes	Variable: `{CssUrl}` When sent to Chase, will be replaced by the value of the `Props > CssUrl` value.
			`action`	`string`	Yes	Variable: `{Action}` When sent to Chase, will be replaced by the value of the `Props > Action` value.
			`payment_type`	`string`	Yes	Variable: `{PaymentType}` When sent to Chase, will be replaced by the value of the `Props > PaymentType` value.
			`formType`	`string`	Yes	Variable: `{FormType}` When sent to Chase, will be replaced by the value of the `Props > FormType` value.
			`allowed_types`	`string`	Yes	Variable: `{AllowedTypes}` When sent to Chase, will be replaced by the value of the `Props > AllowedTypes` value.
			`trans_type`	`string`	Yes	Variable: `{TransType}` When sent to Chase, will be replaced by the value of the `Props > TransType` value.
			`currency_code`	`string`	Yes	Variable: `{CurrencyCode}` When sent to Chase, will be replaced by the value of the `Props > CurrencyCode` value.
			`required`	`string`	Yes	Variable: `{Required}` When sent to Chase, will be replaced by the value of the `Props > Required` value.
			`hosted_tokenize`	`string`	Yes	Variable: `{HostedTokenize}` When sent to Chase, will be replaced by the value of the `Props > HostedTokenize` value.
		`RenderParams`			Yes	Chase-defined parameters to be passed when rendering the payment system screen.
			`hostedSecureID`	`string`	Yes	Variable: `{HostedSecureId}` When sent to Chase, will be replaced by the value of the `Props > HostedSecureId` value.
	`ConfirmPayment`				Yes	Object defining the endpoint and parameters to be passed to Chase when querying payments.
		`QueryParams`			Yes	Chase-defined parameters to be passed when querying payments.
			`hostedSecureID`	`string`	Yes	Variable: `{HostedSecureId}` When sent to Chase, will be replaced by the value of the `Props > HostedSecureId` value.
			`hostedSecureAPIToken`	`string`	Yes	Variable: `{HostedSecureApiToken}` When sent to Chase, will be replaced by the value of the `Props > HostedSecureApiToken` value.
`Headers`				`object`	No
`Props`				`object`	Yes	An array of tenant-specific values which should be used to replace the `{variables}` defined in the specific payment provider's defined `Features` object when being sent to the provider.
	`HostedSecureId`			string	Yes	The tenant's specific Chase hosted secure ID value.
	`HostedSecureApiToken`			string	Yes	The tenant's specific Chase secure API token value.
	`CssUrl`			string	Yes	URL to an externally hosted, publicly accessible CSS file as required by Chase for format the payment system screen when rendered.
	`Action`			string	Yes	For Chase, the literal string: `buildForm`
	`PaymentType`			string	Yes	For Chase, the literal string: `Credit_Card`
	`FormType`			string	Yes	For Chase, the literal string: `4`
	`AllowedTypes`			string	Yes
	`TransType`			string	Yes	For Chase, the literal string: `auth_capture`
	`CurrencyCode`			string	Yes	The current for payments, as supported by Chase (e.g. `USD`).
	`Required`			string	Yes	For Chase, the literal string: `all`
	`HostedTokenize`			string	Yes	For Chase, the literal string: `store_authorize`

ServiceBroker 5

REST Objects Payment Provider

Analytics

Payment Provider Object Format - authorize.net

Payment Provider Object Properties - authorize.net

Payment Provider Object Format - Chase Payment

Payment Provider Object Properties - Chase Payment