Docs / Accept payments
Payment methods
The payment methods available through the Tranzak API, how each one works, and how a payment moves from creation to confirmation.
One endpoint creates a payment, whatever the method. You change only the payment_method field.
Methods
payment_method |
Currency | Minimum | Flow | Live access |
|---|---|---|---|---|
moncash |
HTG. A USD amount is converted to HTG. | Set by Tranzak | Redirect to MonCash | Open |
natcash |
HTG. A USD amount is converted to HTG. | 20 HTG | Redirect to NatCash | Open |
lakaypay_card |
HTG or USD | Set by Tranzak | Redirect, or modal, to a Tranzak-hosted card page | Open |
card (Visa, Mastercard) |
HTG or USD | 0.50 USD | Embedded widget on your page, no redirect | Requires approval |
Note Do not hard-code fees or limits, because they can change. Read the message of a
400 amount_too_lowresponse and thecard_minimumfield of the exchange rate endpoint. Current prices are on the pricing page.
Details for each method:
- MonCash and NatCash: redirect flows.
- Hosted card page: a Tranzak page where the customer enters the card, with recurring payments.
- Embedded card widget: card entry on your own page, powered by Stripe.
How a payment works
- Create. Your server calls
POST /paymentswith the amount, currency and method. Tranzak returns atransaction_id, and apayment_urlfor redirect methods. - Pay. The customer pays on the provider's screen, or in the widget on your page.
- Return. For redirect methods, the customer's browser comes back to your return URL. See Customer return URL.
- Confirm. Your server learns the final status from the signed webhook, or by reading the payment. See Confirm a payment.
Payment statuses
status |
Meaning | Final |
|---|---|---|
pending, processing |
Created. The customer has not finished. | No |
completed |
Paid. | Yes |
failed |
Refused, abandoned or expired. | Yes |
A transaction left in processing for 15 minutes is automatically marked failed, unless it was paid in the meantime. Tranzak checks MonCash and NatCash first.
Recurring payments
Recurring payments are available with lakaypay_card only. See Hosted card page.