Payment methods

Fields description

Attribute	Data Type	Mandatory
order_id	String [max_length: 40]	Yes
credit_note	String [max_length: 40]	Yes
account_id	Integer [max_length:30]	Yes
account_type	String [max_length:9] Allow values: -Ahorro -Monetaria	Yes (Only when `channel` is api)
vat_id	String [max_length:20]	Yes
vat_id_type	String [max_length:3][max_length:3] Allow values: DPI	Yes
name	String [max_length:50]	Yes
amount	Float (Max 2 decimals)	Yes
subject	String[max_length:100] Example: Withdrawal request	Yes
bank_detail	String [max_length:100] Example: User withdrawal request	Yes
channel	String [max_length:100] Example: `transferencia`, `transfer`, `api` o `[Webhook URL] (Only for Cashout)`	Yes
user_email	String [max_length:100][max_length:100] Example: [email protected]	Yes
phone_number	String [max_length:20][max_length:20] Example: +502111111111	Yes
bank	Id value according to bank from /api/banks/?country=GT&fields=id,name	Yes
currency	Id value from /api/currencies/ Allow currencies: GTQ	No

Examples

Bank transfer (API)

[{
  "order_id": "202500629001",
  "credit_note": "202500629001",
  "account_id": "3040267263",
  "account_type": "Monetaria",
  "vat_id": "06247312",
  "vat_id_type": "DPI",
  "name": "Payvalida Guatemala, S.A.",
  "amount": 150.50,
  "subject": "Pago nómina enero 2025",
  "bank_detail": "Pago nómina enero 2025",
  "channel": "transferencia",
  "user_email": "[email protected]",
  "phone_number": "50212345678",
  "bank": //bank_id de banco guatelama
}]

Cash Withdrawal (Cashout)

[{
  "order_id": "2026001029000",
  "credit_note": "2026001029000",
  "account_id": "",
  "account_type": "Monetaria",
  "vat_id": "06247313",
  "vat_id_type": "DPI",
  "name": "María López",
  "amount": 500.00,
  "subject": "Pago cashout prueba",
  "bank_detail": "Pago cashout prueba",
  "channel": "cashout",
  "user_email": "[email protected]",
  "phone_number": "50287654321",
  "bank": //bank_id de banco guatelama
}]