Market specifications

Take a look of all the payment methods available.

Country reference Cards supported APM supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

PayCash SoyFri

Market specifications

Do you want to know more information about Guatemala's market? Go to the Tap Into Latin America’s High-Growth Potential article.

Country reference

`country` code	`currency` code	`amount` decimals	`document` name	`document` format	`document` required?
`GT`	`GTQ`	2	CUI	13 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`AE`	American Express	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DC`	Diners	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DI`	Discover	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`JC`	JCB	`CARD`	Credit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows	Logo
`CY`	PayCash	`TICKET`	Cash Payment	`DIRECT` `REDIRECT`
`FR`	SoyFRI	`TICKET`	Mobile Wallet	`REDIRECT`

Cards

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	American Express	Diners	Discover	JCB
Minimum amount	1 GTQ	1 GTQ	1 GTQ	1 GTQ	1 GTQ	1 GTQ	1 GTQ	1 GTQ
Refunds	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Recurring	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Descriptor	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

PayCash

PayCash is a payment system enabled in the main commercial chains and banks in Latin America, which allows customers to receive and process cash payments and transfers immediately.

Capabilities

	PayCash
Min. amount	1 GTQ
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`GTQ` Transaction currency in ISO 4217.	Yes
`country`	String	`GT` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`CY` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	String	Document of the payer.	Yes
`order_id`	String	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 20,
    "currency": "GTQ",
    "country": "GT",
    "payment_method_id": "CY",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "1234567890123",
        "address": {
            "country": "GT",
            "state": "Guatemala",
            "city": "Guatemala",
            "zip_code": "8858",
            "street": "Av. Principal",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-ff8aedac-3b47-rffd-9fe4-cb0385e568d4",
    "amount": 20,
    "currency": "GTQ",
    "payment_method_id": "CY",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "GT",
    "bank_transfer": {},
    "ticket": {
        "type": "CUSTOM",
        "reference": 4201686593745791,
        "expiration_date": "2023-06-17T23:59:59.000+0000",
        "provider_name": "apm-paycash",
        "provider_logo": "logo",
        "image_url": "https://pay.dlocal.com/gmf-apm/payments/M-8ebc0757-b772-44d9-edsw-a4501ac959c7",
        "amount": 20,
        "currency": "GTQ"
    },
    "created_date": "2023-06-12T22:04:54.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "notification_url": "http://merchantsite.com/notification/new"
}

Example ticket

PayCash UI built with the information in the example above.

SoyFRI

SoyFRI is a wallet payment method in Guatemala that allows users to approve a merchant payment request directly from the SoyFRI app. Users receive a push notification, open the SoyFRI app, review the pending payment, enter their security PIN, choose the funds origin, and confirm the transaction.

Capabilities

	SoyFRI
Min. amount	1 GTQ
Max. expiration time supported	15 days
Daily limit	GTQ 10,000
Notification delay	Immediate
Refunds	No
Flow	`REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`GTQ` Transaction currency in ISO 4217.	Yes
`country`	String	`GT` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`FR` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.phone`	String	Phone number of the payer. Required to deliver the payment request to the user's SoyFRI account.	Yes
`payer.document`	String	Document of the payer.	No
`payer.email`	String	Email of the payer.	No
`order_id`	String	Merchant reference for the payment.	No
`description`	String	Description of the purchase.	No
`callback_url`	String	Optional callback URL. There is currently no automatic return-URL behavior in the SoyFRI UX; users must manually switch back to the merchant app.	No
`notification_url`	String	Notifications will be sent on every status change to the `notification_url` specified by the merchant.	No

Examples

URL Selector with Opacity

Post

Production URL Sandbox URL

{
    "amount": 100,
    "currency": "GTQ",
    "country": "GT",
    "payment_method_id": "FR",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "carlossh",
        "phone": "22222222",
        "email": "[email protected]",
        "document": "1234567890123"
    },
    "order_id": "34545sk3483kqw0",
    "description": "test-101",
    "callback_url": "http://merchantsite.com/success_page",
    "notification_url": "http://merchantsite.com/notification/new"
}

{
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "payment_method_id": "FR",
    "payment_method_flow": "REDIRECT",
    "country": "GT",
    "currency": "GTQ",
    "amount": 100,
    "order_id": "34545sk3483kqw0"
}

{
    "id": "R-4-9f359a37-621c-423b-b552-6d464fe890dd",
    "amount": 100,
    "status": "PAID",
    "status_detail": "The payment was paid.",
    "status_code": "200",
    "currency": "GTQ",
    "country": "GT",
    "payment_method_id": "FR",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "carlossh",
        "phone": "22222222"
    },
    "order_id": "34545sk3483kqw0",
    "description": "test-101",
    "notification_url": "http://merchantsite.com/notification/new",
    "created_date": "2025-06-11T13:13:54.634Z"
}

UI guidelines

📘
SoyFRI payment flow
SoyFRI delivers the payment request to the user via push notification in the SoyFRI app. There is no automatic return URL after the user confirms payment; the user must manually switch back to the merchant app or page. The payer.phone value must match the phone number or username registered in the user's SoyFRI account for the payment request to be delivered correctly.