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

6 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
x-jws-signature <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": "REPLACE WITH SAME VALUE FROM INTENT",
        "Initiation": {
            "InstructionIdentification": "REPLACE WITH SAME VALUE FROM INTENT",
            "EndToEndIdentification": "REPLACE WITH SAME VALUE FROM INTENT",
            "InstructedAmount": {
                "Amount": "55.60",
                "Currency": "ZAR"
            },
            "CreditorAccount": {
                "SchemeName": "SortCodeAccountNumber",
                "Identification": "1987651028232942",
                "Name": "ACME Inc",
                "SecondaryIdentification": "1028232942"
            },
            "RemittanceInformation": {
                "Unstructured": "Maintenance Fee",
                "Reference": "FRESCO-101"
            }
        }
    },
    "Risk": {
        "PaymentContextCode": "EcommerceGoods",
        "MerchantCategoryCode": "5967",
        "MerchantCustomerIdentification": "053598653254",
        "DeliveryAddress": {
            "AddressLine": [
                "Flat 7",
                "Acacia Lodge"
            ],
            "StreetName": "Acacia Avenue",
            "BuildingNumber": "27",
            "PostCode": "GU31 2ZZ",
            "TownName": "Sparsholt",
            "CountrySubDivision": "ginelosdibjuu",
            "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": "41662256",
        "ConsentId": "a1bdae8f-b29d-4271-b189-f8f157db5f7c",
        "Status": "AcceptedSettlementCompleted",
        "CreationDateTime": "2021-06-24T13:50:36+00:00",
        "StatusUpdateDateTime": "2021-06-24T13:53:47+00:00",
        "Initiation": {
            "InstructionIdentification": "abc2021",
            "EndToEndIdentification": "abc123",
            "InstructedAmount": {
                "Amount": "55.60",
                "Currency": "ZAR"
            },
            "CreditorAccount": {
                "SchemeName": "SortCodeAccountNumber",
                "Identification": "1987651001670299",
                "Name": "ACME Inc",
                "SecondaryIdentification": "1001670299"
            },
            "RemittanceInformation": {
                "Reference": "FRESCO-101",
                "Unstructured": "Maintenance Fee"
            }
        }
    },
    "Links": {
        "Self": "https://api.nedbank.com/open-banking/v3.1/pisp/domestic-payments/41662256"
    },
    "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.