Market 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
`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_id as CARD.

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	`ZAR` Transaction 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`

Request Parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged	Yes
`currency`	String	`ZAR` Transaction 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	`ZA` Country 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"
}