Transaction Processing

To process transactions and licenses for content behind a robots.nxt paywall, you must first sign up for an access account.

After gaining access to the access portal, you will want to create an access key. The access key creation process will reveal a secret key used to authorize payment requests for content behind a robots.nxt paywall.

During your request you will want to supply the secret key and price in the request headers.

Secret Key = x-robotsnxt-secret-key Price to Pay = x-robotsnxt-price

The following curl request is an example of how to pass the secret key and price to pay for requested content. In this example, we are using the example.com domain as the site to request and the /blog/some-awesome=blog as the content to request.

curl \
  -H "User-Agent: YourUserAgent" \
  -H "x-robotsnxt-secret-key: YOUR_SECRET_KEY" \
  -H "x-robotsnxt-price: .20" \
  https://example.com/some-awesome-blog

After a successful transaction you will see response headers that include the following:

x-robotsnxt-transaction-id: 01JHREKWB2Z9GJCQG75R3FCSMR
x-robotsnxt-transaction-amount: 0.22
x-robotsnxt-botcheck: Validated by https://paynpoint.net

We allow rehits of the content using the same criteria and transaction for five minutes. After five minutes, the transaction grace period will expire and you will need to reprocess the transaction to access the content again.