Create Payment and Confirm Status
A 3-step recipe with dLocal. We can help you get access.
Recipe · 3 steps
Create Payment and Confirm Status
with dLocal
Resolve a payment method, create a payment, and confirm its final status.
- List the local payment methods supported for the target country so the caller can confirm the chosen method is available before charging.
- Create a payment with the supplied amount, currency, and payer using a DIRECT payment method flow.
- Retrieve the lightweight status snapshot for the payment to confirm whether it has settled or remains pending.
What you'll need to have ready
- country: ISO 3166-1 alpha-2 country code for the payment (e.g. BR).
- currency: ISO-4217 three-letter currency code (e.g. BRL).
- amount: Transaction amount in the specified currency.
- orderId: Merchant-provided order identifier.
- paymentMethodId: Local payment method code to charge (e.g. PIX, CARD).
- payerName: Full name of the payer.
- payerEmail: Email address of the payer.
- payerDocument: National identification document of the payer.
- notificationUrl: URL to receive asynchronous payment status notifications.
For your developer
Arazzo workflow d-local:create-payment-and-confirm-status, 3 operations: searchPaymentMethods → createPayment → retrievePaymentStatus. Specs on APIs.io.