Paxful Pay

Prerequisites

Before you begin, you need to go to Paxful account settings and create your API-key and API-secret. You’ll need to use them later on in the process. Treat your API-secret as a password. Make sure it’s stored safely so that only you have access to it.

After you have generated your API-key and API-secret pair you have to sign up as a merchant. Once you’ve completed the registration, you’ll receive a “merchant ID” which is required to generate the payment links.

Creating an API Seal

For more details on how to generate an API Seal parameter, refer to the HMAC authentication guide.

If your application is written in JavaScript then you can use the following snippet of code as a reference to implement hashing and the payment link generation logic (sign_with_hmac function is taken from HMAC authentication guide):

const apiKey = ''; // specify
const apiSecret = ''; // specify

const queryString = sign_with_hmac(apiKey, apiSecret, {
    merchant: 'kZP5eozAY2d', // change
    to: '2NFy6i3YA87d5kGzrue9TERGaYye7Jm1LMf', // change
    amount: 0.1,
    track_id: Date.now()
});

const link = `https://paxful.com/wallet/pay?${queryString}`;
Successful Request

If the query string is correct the Paxful wallet page send out dialog will open for the user with your specified Bitcoin address and amount pre-filled and the user has to make just 1 click – CONFIRM SEND to confirm the payment.

Unsuccessful Request

While you are developing the button, if the parameters or the HMAC calculation are incorrect, clicking the link will open the Paxful wallet page with detailed error message(s).

Callbacks

Paxful Pay solution can be configured to provide callbacks to an outside address after a successful transaction.

You can set this up on your Merchant dashboard, under “Advanced: Open Customization Callbacks Panel“.

This website uses cookies to ensure you get the best experience on our website.Learn more