Sorry, you need to enable JavaScript to visit this website.

7 Payment Submission

Action

Using the access token from your previous call, you may proceed to make the call for submitting the payment.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/open-banking/v3.1/pisp/domestic-payments
Request
Headers
Header Value Description
Accept application/json content type
Content-Type application/json The content type of the data being sent.
x-fapi-financial-id OB/2017/001 Financial ID.
x-idempotency-key <RANDOM INTEGER> Random integer. It must be unique for every call
Authorization Bearer <ACCESS_TOKEN> Replace with the heavy/submission access token you received from the previous call.
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.
Body JSON 
                                
{
    "Data": {
        "ConsentId": "01HCY05JA2ENJQ2GQXQH0NSG5H",
        "Initiation": {
            "InstructionIdentification": "abc112",
            "EndToEndIdentification": "def123",
            "InstructedAmount": {
                "Amount": "REPLACE WITH SAME VALUE FROM CONSENT CALL",
                "Currency": "REPLACE WITH SAME VALUE FROM INTENT CALL"
            },
            "CreditorAccount": {
                "SchemeName": "SortCodeAccountNumber",
                "Identification": "REPLACE WITH SAME VALUE FROM INTENT CALL",
                "Name": "ACME Inc",
                "SecondaryIdentification": "REPLACE WITH SAME VALUE FROM INTENT CALL"
            },
            "RemittanceInformation": {
                "Reference": "REPLACE WITH SAME VALUE FROM INTENT CALL",
                "Unstructured": "REPLACE WITH SAME VALUE FROM INTENT CALL"
            }
        }
    },
    "Risk": {
        "PaymentContextCode": "EcommerceMerchantInitiatedPayment",
        "MerchantCustomerIdentification": "1234567891",
        "ContractPresentInidicator": false,
        "BeneficiaryPrepopulatedIndicator": false,
        "PaymentPurposeCode": "EPAY",
        "BeneficiaryAccountType": "Business",
        "DeliveryAddress": {
            "AddressLine": [
                "25 Queen Victoria Street",
                "Acacia Lodge"
            ],
            "StreetName": "Kromdraai Road",
            "BuildingNumber": "25",
            "PostCode": "7872",
            "TownName": "Hout Bay",
            "CountrySubDivision": "Gauteng",
            "Country": "ZA"
        }
    }
}

Please replace CONSENT_ID with the ConsentId you received from the intent call.

Please note that all the other body properties must be the same as those in the intent call
Response JSON 
                            
{
    "Data": {
        "DomesticPaymentId": "26381573",
        "ConsentId": "01HCY05JA2ENJQ2GQXQH0NSG5H",
        "Status": "AcceptedSettlementCompleted",
        "CreationDateTime": "2022-12-28T05:09:46+00:00",
        "StatusUpdateDateTime": "2022-12-28T05:14:59+00:00",
        "Refund": {
            "Account": {
                "Identification": "1987651009427721",
                "Name": "Ronaldo Carlos",
                "SchemeName": "SortCodeAccountNumber",
                "SecondaryIdentification": "1009427721"
            }
        },
        "Initiation": {
            "InstructionIdentification": "abc112",
            "EndToEndIdentification": "def123",
            "InstructedAmount": {
                "Amount": "55.60",
                "Currency": "ZAR"
            },
            "DebtorAccount": {
                "SchemeName": "Profile",
                "Identification": "d16a3c533d71f49ae628bf7cf7993c1b"
            },
            "CreditorAccount": {
                "SchemeName": "SortCodeAccountNumber",
                "Identification": "1987651009427726",
                "Name": "ACME Inc",
                "SecondaryIdentification": "1009427726"
            },
            "RemittanceInformation": {
                "Reference": "ba5a937d",
                "Unstructured": "Instant EFT - Test"
            }
        }
    },
    "Links": {
        "Self": "https://api.nedbank.co.za/apimarket/sandbox/open-banking/v3.1/pisp/domestic-payments/26381573"
    },
    "Meta": {}
}

You now have a DomesticPaymentId. Take note of it as you are going to use it in the next call to retrieve the status of the Payment.

Prev step
Next step