Payment Link Object

{
  "id": "plink_K2zwNNSxPyx8w3GZ",
  "object": "payment_link",
  "amount": 120900,
  "currency": "MXN",
  "status": "active",
  "created_at": "2024-08-02T20:28:13Z",
  "expires_at": "2024-08-02T21:28:13Z",
  "mode": "test",
  "url": "https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ",
  "customer_email": "[email protected]",
  "checkout": {
    "description": "Use this field to add a custom description of the product the customer is buying"
  },
  "metadata": {
    "your_order_id": "10000"
  },
  "recipient_account": {
    "holder_id": "771433855",
    "number": "1836027172",
    "type": "checking_account",
    "institution_id": "cl_banco_de_chile"
  },
	"business_profile": {
  	"name":"Merchant Name",
    "category": "009613",
    "tax_id": "774981120"
  }
}

AttributeTypeDescription
idstringUnique identifier for the Payment Link
objectstringIdentifier for the type of object. Its value for Payment Link will always correspond to payment_link
amountintegerThe amount the customer needs to pay, represented as an integer. This value must always be greater than 0.
currencystringCurrency ISO code. For now, we only support CLP and MXN.
statusstringPayment Link status. Can be either active, expired or canceled.
created_atstringPayment Link's creation date, using ISO 8601
expires_atstringPayment Link's expiration date, using ISO 8601. If null, then the payment link will not expire.
modestringIndicates whether the Payment Link is in live mode or in test mode.
urlstringThe public url that can be shared with customers.
metadatahashSet of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

If you create a payment without providing metadata, this field will be null when receiving notifications about the final status.
customer_emailstringEmail used to notify the customer in case of a refund. If you plan on using the refunds product, you must include this field in your request

If you create a payment without providing a customer_email, this field will be null and the customer will not receive refund notifications by email.
checkoutdictionaryCustomize the checkout for your customers. For now, you can only add a custom description alongside the buy button.
recipient_accountobject(Optional and only available in Chile) The recipient account object must be included if your organization uses Direct Payments .
business_profileobjectEnrolled merchant identifier used for category-based billing.

Recipient Object

AttributeTypeDescription
holder_idstringIdentifier of the owner of the account. In Chile, the value corresponds to a RUT and in Mexico it's either an RFC or CURP. The editable field indicates whether the user is allowed to change the preset username or not.
numberstringAccount number. Does not include hyphens or prefixed zeros
typestringAccount type. It can be checking_account or sight_account
institution_idstringAccount's institution id. You can learn more about institutions and their ids here

Business Profile Object

AttributeTypeDescription
namestringEnrolled merchant´s name. If set, will be shown as the "Recipient" on the payment screens.
categorystringIdentifier of the category of the enrolled merchant. In Chile, it corresponds to a 6 character SII activity code.
tax_idstringEnrolled merchant's tax identifier. In Chile, it corresponds to a RUT.