To use the Clip in MaviBot, you need to create a pair of credentials in your Clip account and enter them in the payment system settings.

Clip is a Mexican payment service.

Obtaining Credentials

Sign an agreement with Clip and get access to the Developer Dashboard in your Clip account.

In the credentials section, click Crear credencial (Create credentials), enter a name, and confirm the creation.

Copy the following credentials:

  • API key
  • Clave secreta (Secret key)

Important! The Secret key is displayed only once, immediately after the credentials are created. Save it in a secure location. You cannot view it again in your Clip account. If you lose it, you will need to create a new pair of credentials.

Credentials are created separately for production and test environments. You can create up to 6 applications per account.

For integration testing, create a test pair of credentials. To accept real payments, use production credentials.

You do not need to configure a payment notification URL in your Clip account. MaviBot automatically sends the notification URL when each payment is created.

Connecting Clip

In the Acquiring tab, select Clip and enter:

Field Description
API key Application identifier.
Secret key (Clave secreta) Application secret key.

The connection is now complete.

Use the following Calculator function:

get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)

Parameters

Parameter Description
amount Payment amount. Required. The minimum amount is 1 in the major currency unit. Specify the amount as 100.55, not 10055.
description Payment description. Optional. Maximum length: 250 characters. The customer can see it on the payment page and receipt.
currency Three-letter currency code (MXN and other currencies available for your Clip account). Optional. Default: MXN.
customer_email Customer's email address. Optional. Automatically inserted into the payment form.
customer_phone Customer's phone number. Optional. Automatically inserted into the payment form.
full_name Customer's name. Optional. Automatically inserted into the payment form.
product_name Product name. Optional.
language Payment page language: es for Spanish (default) or en for English.

The function returns a payment URL.

To send a payment button to the customer:

  1. Create a button with the Pay function.
  2. Select Clip as the payment system.
  3. Specify the product name, amount, and currency.
  4. If necessary, specify variables containing the customer's name, email address, and phone number.

Payment Callbacks

After the customer follows the payment link and completes the payment, MaviBot receives a callback.

Successful Payment

Example:

SDJ91MTKTT_success 100.55

Where:

  • SDJ91MTKTT — the first 10 characters of your API key.
  • 100.55 — the payment amount.

Failed Payment

If the payment is unsuccessful, the following callback is sent:

SDJ91MTKTT_fail 100.55

Important! A failed-payment callback is sent only after the payment link is permanently closed: after 5 unsuccessful payment attempts or when the link expires.

As long as the customer still has payment attempts available, the link remains active and no failed-payment callback is sent.

Customer Variables After a Successful Payment

Variable Description
clip_callback_data Payment information received from the Clip payment system.
clip_payment_completed "True" if the payment was successfully processed.
clip_payment_request_id Payment link identifier in Clip.
clip_receipt_no Clip receipt number.