Paywall Response

Here you can find information about the response received after sending a POST Create Paywall request.

If successful, the response returns a paywall ID under the parameter uid as well as information about the paywall. This paywall ID can be used as parameter of the GET Paywall request to retrieve the paywall information at any time.

The object form contains the URL of the paywall. You must redirect your users to this URL after sending the request for them to go through with the transaction. After that, everything is handled directly on the paywall and the payment method's checkout page.

The transaction ID will be generated after the customer finishes filling the paywall form and is redirected to the checkout page of the payment method. This event will generate a new PENDING transaction and trigger a callback sent to the request’s notificationUrl with the transaction ID. Your users will be redirected to the returnUrl after finishing on the checkout page.

Paywall Response Fields

Here is the list of all fields of the response with their associated description.

FieldDescription
uidThe ID of the paywall created.
trackingIdThe tracking ID used in the request. If omitted, the value will be null.
amountThe amount of the transaction.
currencyThe currency of the shop used.
descriptionThe description used in the request. If omitted, the value will be null.
createdAtThe timestamp of the creation date of the paywall.
returnUrlThe return Url used in the request. If omitted, the value will be null.
notificationUrlThe notification Url sent in the request. If omitted, the value will be null.
shopNameThe name of the shop used to create the request.
languageThe language that will be displayed on the paywall and the payment method checkout page.
totalAmountThe amount converted from integer to float.
expirationDateThe expiration date of the paywall.
transactionIdThe ID of the transaction generated with the paywall.
CurrencySymbolThe symbol of the currency of the transaction.
apiPaymentShopDomainUrlThe base endpoint of the API.
customerThe object containing the customer information. Any unrequired field left out of the request will have a value of null.
formThe object that contains the URL of the paywall that must be used to redirect the user.
whitelabelAn object that contains information related to the aspect of the paywall. If the paywall was not customised, every parameter inside of this object will have a value of null.
isLocalCurrencyDepreciated. Will always have a value of false.
isConvertedToLocalCurrencyDepreciated. Will always have a value of false.
convertedAmountLocalCurrencyDepreciated. Will always have a value of null.
localCurrencySymbolDepreciated. Will always have a value of null.
localCurrencyDepreciated. Will always have a value of null.
testModeBoolean that differentiates real paywalls from test paywalls.
showModalDepreciated. Will always have a value of false.