Domestic Standing Order Payment API allows customer initiation of Standing Order Payment for scheduled EFTS NRT, DNS and BIL payments.
The API endpoint allows the PISP to ask an ASPSP to create a new domestic-standing-order-consents resource.
Request to create payment consent:
https://host:port/api/bobf/release1.0.0/domestic-standing-order-consents
Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL
x-idempotency-key: XYZ.51403.MLT.30
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-auth-date: Tue, 18 Mar 2022 19:43:31 GMT+03:00
x-fapi-customer-ip-address: 204.35.213.15
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
Accept: application/json
{
"Data": {
"Permission": "Create",
"ReadRefundAccount": "No",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
},
"Authorisation": {
"AuthorisationType": "Single",
"CompletionDateTime": "2022-06-18T08:26:39.976+03:00"
},
"SCASupportData": {
"RequestedSCAExemptionType": "BillPayment",
"AppliedAuthenticationApproach": "SCA",
"ReferencePaymentOrderId": "035762"
}
},
"Risk": {
"PaymentContextCode": "BillPayment",
"MerchantCategoryCode": "002345",
"MerchantCustomerIdentification": "0023456789",
"DeliveryAddress": {
"AddressLine": ["Block 317, Road 1702, Building 96"],
"StreetName": "Route 1888",
"BuildingNumber": "27",
"PostCode": "317",
"TownName": "Manama",
"CountrySubDivision": ["Manama"],
"Country": "BH"
}
}
}
Response:
201 Created
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
{
"Data": {
"ConsentId": "7X9LfGqZRtit_NQW_PQ3-Q",
"CreationDateTime": "2022-06-29T19:34:03.619+03:00",
"Status": "AwaitingAuthorisation",
"StatusUpdateDateTime": "2022-06-29T19:34:03.619+03:00",
"Permission": "Create",
"ReadRefundAccount": "No",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
},
"Authorisation": {
"AuthorisationType": "Single",
"CompletionDateTime": "2022-06-18T08:26:39.976+03:00"
},
"SCASupportData": {
"RequestedSCAExemptionType": "BillPayment",
"AppliedAuthenticationApproach": "SCA",
"ReferencePaymentOrderId": "035762"
}
},
"Risk": {
"PaymentContextCode": "BillPayment",
"MerchantCategoryCode": "002345",
"MerchantCustomerIdentification": "0023456789",
"DeliveryAddress": {
"AddressLine": [
"Block 317, Road 1702, Building 96"
],
"StreetName": "Route 1888",
"BuildingNumber": "27",
"PostCode": "317",
"TownName": "Manama",
"CountrySubDivision": [
"Manama"
],
"Country": "BH"
}
},
"Links": {
"Self": "https://pg:9045/authpage/spoConsentId/7X9LfGqZRtit_NQW_PQ3-Q"
}
}
A PISP can optionally retrieve a payment resource that has been created to check its status.
https://host:port/api/bobf/release1.0.0/domestic-standing-order-consents/7X9LfGqZRtit_NQW_PQ3-Q
Request:
Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL
x-idempotency-key: XYZ.51403.MLT.30
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-auth-date: Tue, 18 Mar 2022 19:43:31 GMT+03:00
x-fapi-customer-ip-address: 204.35.213.15
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
Accept: application/json
Response:
200 OK
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
{
"Data": {
"ConsentId": "7X9LfGqZRtit_NQW_PQ3-Q",
"CreationDateTime": "2022-06-29T19:34:03+03:00",
"Status": "Consumed",
"StatusUpdateDateTime": "2022-06-29T19:35:23+03:00",
"Permission": "Create",
"ReadRefundAccount": "No",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.3",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.3",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
},
"Authorisation": {
"AuthorisationType": "Single",
"CompletionDateTime": "2022-06-18T08:26:39.976+03:00"
},
"SCASupportData": {
"RequestedSCAExemptionType": "BillPayment",
"AppliedAuthenticationApproach": "SCA",
"ReferencePaymentOrderId": "035762"
}
},
"Risk": {
"PaymentContextCode": "BillPayment",
"MerchantCategoryCode": "002345",
"MerchantCustomerIdentification": "0023456789",
"DeliveryAddress": {
"AddressLine": [
"Block 317, Road 1702, Building 96"
],
"StreetName": "Route 1888",
"BuildingNumber": "27",
"PostCode": "317",
"TownName": "Manama",
"CountrySubDivision": [
"Manama"
],
"Country": "BH"
}
},
"Links": {
"Self": "https://pg:9045/authpage/spoConsentId/7X9LfGqZRtit_NQW_PQ3-Q"
}
}
Once the domestic-standing-order-consents has been authorised by the user/customer, the PISP should proceed to submit the domestic-standing-orders for processing.
Request to initiate domestic standing orders:
https://host:port/api/bobf/release1.0.0/domestic-standing-orders
Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL
x-idempotency-key: XYZ.51403.MLT.30
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-auth-date: Tue, 18 Mar 2022 19:43:31 GMT+03:00
x-fapi-customer-ip-address: 204.35.213.15
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
Accept: application/json
{
"Data": {
"ConsentId": "7X9LfGqZRtit_NQW_PQ3-Q",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
}
},
"Risk": {
"PaymentContextCode": "BillPayment",
"MerchantCategoryCode": "002345",
"MerchantCustomerIdentification": "0023456789",
"DeliveryAddress": {
"AddressLine": ["Block 317, Road 1702, Building 96"],
"StreetName": "Route 1888",
"BuildingNumber": "27",
"PostCode": "317",
"TownName": "Manama",
"CountrySubDivision": ["Manama"],
"Country": "BH"
}
}
}
Response:
201 Created
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/jsonson
{
"Data": {
"DomesticStandingOrderId": "7X9LfGqZRtit_NQW_PQ3-Q",
"ConsentId": "7X9LfGqZRtit_NQW_PQ3-Q",
"CreationDateTime": "2022-06-29T19:34:03+03:00",
"Status": "InitiationCompleted",
"StatusUpdateDateTime": "2022-06-29T19:35:23.504+03:00",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.30",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
}
},
"Links": {
"Self": "https://pg:9045/authpage"
}
}
A PISP can optionally retrieve a payment resource that has been created to check its status.
Request:
https://host:port/api/bobf/release1.0.0/domestic-standing-orders/7X9LfGqZRtit_NQW_PQ3-Q
Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL
x-idempotency-key: XYZ.51403.MLT.30
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-auth-date: Tue, 18 Mar 2022 19:43:31 GMT+03:00
x-fapi-customer-ip-address: 204.35.213.15
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
Accept: application/json
Response:
200 OK
x-jws-signature: V2hhdCB3ZSBnb3QgaGVyZQ0K..aXMgZmFpbHVyZSB0byBjb21tdW5pY2F0ZQ0K
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Content-Type: application/json
{
"Data": {
"DomesticStandingOrderId": "7X9LfGqZRtit_NQW_PQ3-Q",
"ConsentId": "7X9LfGqZRtit_NQW_PQ3-Q",
"CreationDateTime": "2022-06-29T19:34:03+03:00",
"Status": "InitiationCompleted",
"StatusUpdateDateTime": "2022-06-29T19:35:23+03:00",
"Initiation": {
"Frequency": "EvryDay",
"Reference": "202200629_01",
"FirstPaymentDateTime": "2022-06-29T08:26:39.976+03:00",
"RecurringPaymentDateTime": "2022-06-30T08:26:39.976+03:00",
"FinalPaymentDateTime": "2022-07-03T08:26:39.976+03:00",
"FirstPaymentAmount": {
"Amount": "8.44",
"Currency": "BHD"
},
"RecurringPaymentAmount": {
"Amount": "6.3",
"Currency": "BHD"
},
"FinalPaymentAmount": {
"Amount": "6.3",
"Currency": "BHD"
},
"DebtorAccount": {
"SchemeName": "BH.OBF.PAN",
"Identification": "100000003385",
"Name": " Khalid Ahmed Ali"
},
"CreditorAccount": {
"SchemeName": "BH.OBF.IBAN",
"Identification": "BH26ICIC12345678901234",
"Name": "Mohammed Ahmed Abdulla"
}
}
},
"Links": {
"Self": "https://pg:9045/authpage"
}
}
A PISP can retrieve the Details of the underlying payment transaction via this endpoint. This resource allows ASPSPs to return richer list of Payment Statuses, and if available payment scheme related statuses.
Request:
https://host:port/api/bobf/release1.0.0/domestic-standing-orders/7X9LfGqZRtit_NQW_PQ3-Q/payment-details
Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL
x-idempotency-key: XYZ.51403.MLT.30
x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==
x-fapi-auth-date: Tue, 18 Mar 2022 19:43:31 GMT+03:00
x-fapi-customer-ip-address: 204.35.213.15
x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f
Content-Type: application/json
Accept: application/json
Response:
{
"Data": {
"PaymentStatus": [
{
"PaymentTransactionId": "OBT2206290000201",
"Status": "AcceptedCreditSettlementCompleted",
"StatusUpdateDateTime": "2022-06-29T19:53:23.089+03:00"
}
]
}
}