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

2 Request Payment Consent ID

Action

Using the Payment intent access token you received in the previous call, proceed to make a payment consent call to receive a Consent ID using the endpoint and values below.


Method POST
Endpoint https://api.nedbank.co.za/apimarket/sandbox/open-banking/v3.1/pisp/domestic-payment-consents
Request
Headers
Header Value Description
Content-Type application/json The data type being sent to the endpoint.
x-fapi-financial-id OB/2017/001 Financial ID.
Accept application/json content type
x-jws-signature <RANDOM INTEGER> Random integer. Must be unique for every call
x-idempotency-key <RANDOM INTEGER> Random integer. Must be unique for every call
Authorization Bearer <ACCESS_TOKEN> The access token you received from the previous call. Replace <ACCESS_TOKEN> with the access token you received.
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": {
        "Initiation": {
            "InstructionIdentification": "REPLACE WITH RANDOM UNIQUE STRING",
            "EndToEndIdentification": "REPLACE WITH RANDOM UNIQUE STRING",
            "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 edit {$CreditorAccount} object with your account details

Response JSON
                    
{
    "Data": {
        "ConsentId": "a1bdae8f-b29d-4271-b189-f8f157db5f7c",
        "Status": "AwaitingAuthorisation",
        "CreationDateTime": "2021-06-24T05:58:11+00:00",
        "StatusUpdateDateTime": "2021-06-24T05:58:11+00:00",    
        "Initiation": {
            "InstructionIdentification": "abc2021",
            "EndToEndIdentification": "abc123",
            "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"
        }
    },
    "Links": {
        "Self": "https://api.nedbank.com/open-banking/v3.1/pisp/domestic-payment-consents/a1bdae8f-b29d-4271-b189-f8f157db5f7c"
    },
    "Meta": {}
}            
                    
                    

You now have a ConsentID. Take note of it as you are going to use it in the next call.