Betaling bewerken

Een betaling bewerken in het systeem kan op twee manieren. Een HTTP POST-request of met een HTTPGET-request naar api.ideal-service.nl. In dit request zijn een aantal parameters nodig.

Benodigde parameters

Hieronder staan de parameter die nodig zijn om succesvol een betaling te bewerken.

Parameter	Omschrijving	Type	Controle	Min.lengte	Max.lengte	Verplicht
action	Aangeven dat het om bewerken gaat	string	moet 'edit' zijn			ja
apiKey	API-toegangssleutel	string	geldigheid	1	50	ja
paymentId	Uniek ID van betaling	string	moet bekend zijn, en niet betaald	1	32	ja
description	Omschrijving betaling	string	alfanummeriek	1	32	nee
reference	Referentie betaling	string	alfanummeriek/uniek	1	32	nee
amount	bedrag in centen	int	nummeriek	min. 0,85	max. 10.000,00	nee
maxpaydate	tot wanneer betaald mag worden	date-string	format(YYYY-MM-DD)	0	10	nee

Resultaat van request

Als u een request gedaan heeft krijgt u ten alle tijden een reactie. De reactie is een JSON-response. Hieronder ziet u een succesvolle response en een foutieve response.

    {"success":true,"paymentId":"owLBqfNphX","paymentLink":"http:\/\/www.ideal-service.nl\/owLBqfNphX"}
    // OF
    {"success":false,"errorCode":"OV0014","errorMessage":"No correct paymentId given"}

Parameters die u terug krijgt bij een succesvolle mutatie zijn:

Parameter	Type	Omschrijving
success	bool(true)	geeft aan dat de request succesvol is uitgevoerd
paymentId	string	het id van de betaling
paymentLink	string	de rechtstreekse link naar de betaling

Parameters die u terug krijgt bij een foutieve mutatie zijn:

Parameter	Type	Omschrijving
success	bool(false)	geeft aan dat de request niet succesvol is
errorCode	string	de code van de foutmelding
errorMessage	string	de omschrijving van de foutmelding

Voorbeeld code

Om de code te gebruiken kunt u zelf uw eigen script schrijven, maar u kunt ook gebruik maken van de class die wij hebben gemaakt voor het gemakkelijk inschieten van betalingen. Deze kunt u hier downloaden.

    require( 'lib/idealPayment.class.php' );

    $apiKey  = 'HIERUWAPISLEUTEL';
    $payment = new idealPayment( $apiKey );
    $response = $payment->editPayment( 'owLBqfNphX', '', 15095 );
    
    echo $response;