Skip to main content

Schedule


Endpoint

/v1/External/SchedulePayment

Http Request Method

PUT

Request Body

NameTypeDescriptionChild Attributes
campaignNum numberCampaign number associated with the payment, if any.Placeholder
campaignName stringCampaign name associated with the payment, if any.Placeholder
amount numberTotal amount of the payment.Placeholder
ccNum stringCredit card number used for the payment.Placeholder
expiry stringCredit card expiration date (MMYY).Placeholder
cvv stringCredit card CVV security code.Placeholder
note stringAdditional note for the payment.Placeholder
paymentDate stringDate and time of the payment in ISO format.Placeholder
paymentMethodId numberIdentifier for the payment method used.Placeholder
uniqueTransactionId stringUnique identifier for the transaction.Placeholder
currency stringCurrency code (e.g., USD) used for the payment.Placeholder
orgGUID stringOrganization GUID associated with the payment.Placeholder

Response

NameTypeDescriptionChild Attributes
scheduleID number | nullIdentifier for the payment schedule, if applicable.Placeholder
scheduleTotal number | nullTotal amount for the schedule, if applicable.Placeholder
paymentId numberUnique identifier for the payment transaction.Placeholder
statusId numberIdentifier for the status of the payment.Placeholder
serverRejected stringIndicates if the payment was rejected by the server.Placeholder
approval stringApproval status of the payment.Placeholder
receiptNum stringReceipt number associated with the payment.Placeholder
accountId numberIdentifier for the account associated with the payment.Placeholder
currencyAmount numberAmount of the payment in the specified currency.Placeholder
currency stringCurrency code (e.g., USD) used for the payment.Placeholder
paymentStatus stringCurrent status of the payment.Placeholder
isRecurring booleanIndicates whether the payment is recurring.Placeholder
responseTitle string | nullTitle of the response message, if any.Placeholder
isPaymentExist booleanIndicates whether a payment record exists.Placeholder
errorResponse string | nullError response message, if any.Placeholder

See list of possible errors.


Example:

cURL:

curl --location 'https://dev.api.donary.com/v1/External/SchedulePayment' \
--header 'APIKey: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{"scheduleDetails":{"amountPerPayment":1,"totalPaymentsCount":5,"startDate":"2024-08-08T11:29:00.595Z","frequencyID":1,"firstPaymentAmount":1},"donor":{"accountNum":null,"firstName":"Test","lastName":"Charity","phoneNumber":"1231231233"},"campaignNum":null,"campaignName":null,"reason":{"reasonNum":null,"reasonName":null},"amount":5,"ccNum":"4242424242424242","expiry":"1228","cvv":"456","note":"Test Schedule","paymentDate":"2024-08-11T11:29:00.595Z","paymentMethodId":4,"uniqueTransactionId":"0b94c505-b06e-4f97-90d2-f231c05f420f2-1","currency":"USD","reasons":[{"reasonNum":null,"reasonName":null,"reasonAmount":null}],"bankAccount":{"routingNum":null,"accountNum":null,"accountType":null,"checkType":null,"nameOnAccount":null},"orgGUID":"115e9d3d-baf2-4089-b896-9b2621ffcf1b"}'

Payload:

{
"scheduleDetails": {
"amountPerPayment": 1,
"totalPaymentsCount": 5,
"startDate": "2024-08-08T11:29:00.595Z",
"frequencyID": 1,
"firstPaymentAmount": 1
},
"donor": {
"accountNum": null,
"firstName": "Test",
"lastName": "Charity",
"phoneNumber": "1231231233"
},
"campaignNum": null,
"campaignName": null,
"reason": {
"reasonNum": null,
"reasonName": null
},
"amount": 5,
"ccNum": "4242424242424242",
"expiry": "1228",
"cvv": "456",
"note": "Test Schedule",
"paymentDate": "2024-08-11T11:29:00.595Z",
"paymentMethodId": 4,
"uniqueTransactionId": "0b94c505-b06e-4f97-90d2-f231c05f420f2-1",
"currency": "USD",
"reasons": [
{
"reasonNum": null,
"reasonName": null,
"reasonAmount": null
}
],
"bankAccount": {
"routingNum": null,
"accountNum": null,
"accountType": null,
"checkType": null,
"nameOnAccount": null
},
"orgGUID": "115e9d3d-baf2-4089-b896-9b2621ffcf1b"
}

Response:

{
"scheduleID": null,
"scheduleTotal": null,
"paymentId": 4885712,
"statusId": 1,
"serverRejected": "",
"approval": "Success",
"receiptNum": "1087-1",
"accountId": 3702852,
"currencyAmount": 1.0000,
"currency": "USD",
"paymentStatus": "Success",
"isRecurring": true,
"responseTitle": null,
"isPaymentExist": false,
"errorResponse": null,
"error": {
"errorCode": null,
"message": null
}
}