Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mattildapayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Payment links allows you to generate a link, send it to a customer via email/sms/etc, and then have the customer pay without the need for you to host your own checkout. You can use the payment links endpoint to create a payment link with the data that will be displayed on the mattilda Pay hosted page. The payment links API endpoint makes it easy to get create a new payment link. 
{
  "currency":"MXN",
  "country":"MX",
  "amount":1000,
  "metadata":{
    "TypeOfPayment":"purchase",
    "Carbon_FootPrint":"10"
  },
  "cart_items":[
    {
      "name":"Aloe",
      "unit_amount":1000,
      "quantity":1,
      "sku":"aloe"
    }
  ],
  "merchant_banner_url":"https://susies.store/logo.svg",
  "merchant_color":"#cf6b6b",
  "merchant_name":"Susie's Store",
  "merchant_message":"Thanks for your purchase at Susie's Store!",
  "merchant_terms_and_conditions_url":"https://susies.store/terms-and-conditions",
  "return_url":"https://susies.store/success"
}
The payment link will include the expires_at, status, and other useful information that will be used by the mattilda Pay hosted page. Make note of the returned id as it will be used in the next step. 
{
    "id": "09e90ace-a746-41f5-88d2-8b16335ded97",
    "type": "payment-link",
    "expires_at": "2025-01-28T14:45:45.929102+00:00",
    "amount": 1000,
    "currency": "MXN",
    "country": "MX",
    "status": "active",
    ...
}
On top of the merchant_* specific values, this API supports values that are going to be displayed by the mattilda Pay hosted page and also passed to Embed to process the transaction.
  • amount
  • currency
  • country
  • metadata
  • cart_items
  • buyer
  • externalIdentifier
  • intent
  • paymentSource
By creating a payment link you’re ready to send it to your customer to complete the payment.