South Africa
Learn about the dLocal supported payment methods in South Africa.
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.
Bank Transfer PayflexMarket specifications
Do you want to know more information about South Africa's market? Go to the South Africa’s economy and eCommerce market article.
Country reference
country code | currency code | document name | document format | document required? |
|---|---|---|---|---|
ZA | ZAR | South African Identity Card | 13 digits with full validation | Yes |
Cards supported
payment_method_id | Brand ID | Name | payment_method_type | Details | Allowed Flows | Logo |
|---|---|---|---|---|---|---|
CARD | VI | Visa | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | MC | Mastercard | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | VD | Visa Debit | CARD | Debit Card | DIRECT REDIRECT |  |
CARD | MD | Mastercard Debit | CARD | Debit Card | DIRECT REDIRECT |  |
CARD | AE | American Express | CARD | Credit Card | DIRECT |  |
To offer all the card options that may be available in your integration, send the
payment_method_idasCARD.
Alternative Payment Method supported
payment_method_id | Name | payment_method_type | Details | Allowed Flows | Logo |
|---|---|---|---|---|---|
ZT | Stitch | BANK_TRANSFER | Bank Transfer | REDIRECT |  |
FX | Payflex | TICKET | Wallet | REDIRECT |  |
Cards
Capabilities
| Visa Credit | Mastercard Credit | Visa Debit | Mastercard Debit | American Express | |
|---|---|---|---|---|---|
| Minimum amount | 1 ZAR | 1 ZAR | 1 ZAR | 1 ZAR | 1 ZAR |
| Refunds | Yes | Yes | Yes | Yes | Yes |
| Recurring | Yes | Yes | Yes | Yes | Yes |
| Chargeback option | Yes | Yes | Yes | Yes | Yes |
| Chargeback Dispute option | Yes | Yes | Yes | Yes | Yes |
| Descriptor | Merchant name or description provided by the merchant. | Merchant name or description provided by the merchant. | Merchant name or description provided by the merchant. | Merchant name or description provided by the merchant. | Merchant name or description provided by the merchant. |
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
Bank Transfer
Capabilities
| Bank Transfer | |
|---|---|
| Min. amount | 100 ZAR |
| Max. expiration time supported | 1 day |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | REDIRECT |
UX Flow
Request Parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | ZARTransaction currency in ISO 4217. | Yes |
country | String | ZA Transaction country in ISO 3166. | Yes |
payment_method_id | String | ZT ID of the selected payment method | Yes |
payment_method_flow | String | REDIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | 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": 1000,
"currency": "ZAR",
"country": "ZA",
"payment_method_id": "ZT",
"payment_method_flow": "REDIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890123",
"address": {
"country": "ZA",
"state": "Cape Town",
"city": "Cape Town",
"zip_code": "8858",
"street": "Street 1",
"number": "540"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "R-4-ef95f10e-678e-423e-76ss-e574b98a9cbe",
"amount": 1000,
"currency": "ZAR",
"payment_method_id": "ZT",
"payment_method_type": "BANK_TRANSFER",
"payment_method_flow": "REDIRECT",
"country": "ZA",
"created_date": "2023-01-23T19:02:09.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchant.com/notification/new",
"redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-69571584-70e8-41b2-a9f0-a33cb4ace4e7"
}
Payflex
Payflex is a popular Buy Now Pay Later (BNPL) online payment method in South Africa that allows shoppers to pay for their purchase in full or in 4 installments over six weeks, interest-free.
Customers only need to pay 25% of the purchase price on the day they place their order.
Capabilities
| Payflex | |
|---|---|
| Min. Amount. | 1 ZAR |
| Expiration | 30 Minutes |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | REDIRECT |
UX Flow
First-time user
The screenshots illustrate a Payflex first-time user flow. The specifics of the flow may vary depending on the payment method selected to complete the payment.
Existing user
The screenshots illustrate a Payflex existing user flow. The specifics of the flow may vary depending on the payment method chosen to complete the payment.
Request Parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged | Yes |
currency | String | ZARTransaction currency in ISO 4217. | Yes |
country | String | ZA Transaction country in ISO 3166. | Yes |
payment_method_id | String | FX ID of the selected payment method. | Yes |
payment_method_flow | String | REDIRECT | Yes |
payer.name | String | Name of the payer | Yes |
payer.email | String | Email of the payer | Yes |
payer.document | Number | Document of the payer. | Yes |
address.country | String | ZACountry of the payer. | Yes |
address.state | String | State of the payer. | Yes |
address.city | String | City of the payer. | Yes |
address.zip_code | Number | ZIP code of the payer. | Yes |
address.street | String | Street of the payer. | Yes |
address.number | Number | Street number of the payer. | Yes |
order_id | Number | 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. | Yes |
Examples
{
"amount": 1000,
"currency": "ZAR",
"country": "ZA",
"payment_method_id": "FX",
"payment_method_flow": "REDIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890123",
"address": {
"country": "ZA",
"state": "Cape Province",
"city": "Cape Town",
"zip_code": "88058",
"street": "Rodovia Armando Calil Bulos",
"number": "5940"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchant.com/success_page"
}
{
"id": "R-4-e98ed216-b10d-ty54-885f-eb7a751a3a12",
"amount": 1000,
"currency": "ZAR",
"payment_method_id": "FX",
"payment_method_type": "TICKET",
"payment_method_flow": "REDIRECT",
"country": "ZA",
"created_date": "2023-01-23T19:02:09.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "345453483kqws0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-6f5d5f37-67y5-48f2-9e6f-fb911ca4ba39"
}
Updated about 1 month ago