Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel1
stylenone

...

Name

Occurrence

XPath

EnhancedDefinition

Class

Codes

Pattern

OBWriteInternationalConsentResponse

 

OBWriteInternationalConsentResponse

 

OBWriteInternationalConsentResponse

 

 

Data

1..1

OBWriteInternationalConsentResponse/Data

 

OBWriteInternationalConsentResponse/Data

 

 

ConsentId

1..1

OBWriteInternationalConsentResponse/Data/ConsentId

OB: Unique identification as assigned by the ASPSP (Bank) to uniquely identify the consent resource.

String

 

 

CreationDateTime

1..1

OBWriteInternationalConsentResponse/Data/CreationDateTime

Date and time at which the resource was created.

DateTime

 

 

Status

1..1

OBWriteInternationalConsentResponse/Data/Status

Specifies the status of consent resource in code form.

String

Enum:

  • Authorised

  • AwaitingAuthorisation

  • Consumed

  • Rejected

 

StatusUpdateDateTime

1..1

OBWriteInternationalConsentResponse/Data/StatusUpdateDateTime

Date and time at which the resource status was updated.

DateTime

 

 

ReadRefundAccount

0..1

OBWriteInternationalConsent/Data/ReadRefundAccount

Specifies to share the refund account details with PISP

String

Enum:

  • Yes

  • No

 

CutOffDateTime

0..1

OBWriteInternationalConsentResponse/Data/CutOffDateTime

Specified cut-off date and time for the payment consent.

DateTime

 

 

ExpectedExecutionDateTime

0..1

OBWriteInternationalConsentResponse/Data/ExpectedExecutionDateTime

Expected execution date and time for the payment resource.

DateTime

 

 

ExpectedSettlementDateTime

0..1

OBWriteInternationalConsentResponse/Data/ExpectedSettlementDateTime

Expected settlement date and time for the payment resource.

DateTime

 

 

Charges

0..n

OBWriteInternationalConsentResponse/Data/Charges

Set of elements used to provide details of a charge for the payment initiation.

OBWriteInternationalConsentResponse/Data/Charges

 

 

ChargeBearer

0..n

OBWriteInternationalConsentResponse/Data/Charges/ChargeBearer

Specifies which party/parties will bear the charges associated with the         processing of the payment transaction.

String

Enum:

  • BorneByCreditor

  • BorneByDebtor

  • FollowingServiceLevel

  • Shared 

 

Type

0..n

OBWriteInternationalConsentResponse/Data/Charges/ Type

Charge type, in a coded form.

String

Enum:
TBD

 

Amount

0..n

OBWriteInternationalConsentResponse/Data/Charges/Amount

Amount of money associated with the charge type.

OBWriteInternationalConsentResponse/Data/Charges/Amount

 

 

Amount

0..n

OBWriteInternationalConsentResponse/Data/Charges/Amount/Amount

A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.

String

 

^\d{1,13}$|^\d{1,13}.\d{1,5}$

Currency

0..n

OBWriteInternationalConsentResponse/Data/Charges/Amount/Currency

A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition  of the international standard ISO 4217 "Codes for the representation of currencies and funds

String

 

^[A-Z]{3,3}$

ExchangeRateInformation

0..1

OBWriteInternationalConsentResponse/Data/ExchangeRateInformation

Further detailed information on the exchange rate that has been used in the payment transaction.

OBExchangeRateResponse

 

 

Initiation

1..1

OBWriteInternationalConsentResponse/Data/Initiation

The Initiation payload is sent by the initiating party to the ASPSP (Bank). It is used to request movement of funds from the debtor account to a creditor for a single international payment.

OBInternationalPaymentInitiation

 

 

Authorisation

0..1

OBWriteInternationalConsentResponse/Data/Authorisation

The authorisation type request from the PISP.

OBAuthorisation

 

 

SCASupportData

0..1

OBWriteInternationalConsentResponse/Data/SCASupportData

Supporting Data provided by PISP, when requesting SCA Exemption.

OBSCASupportData

 

 

Debtor

0..1

OBWriteInternationalConsentResponse/Data/Debtor

Set of elements used to identify a person or an organisation.

OBWriteInternationalConsentResponse/Data/Debtor

 

 

Name

1..1

OBWriteInternationalConsentResponse/Data/Debtor/Name

The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSPs (Banks)online channels.

String

 

 

Risk

1..1

OBWriteInternationalConsentResponse/Risk

The Risk section is sent by the initiating party to the ASPSP (Bank). It is used to specify additional details for risk scoring for Payments.

OBRisk

 

 

...

Name

Occurrence

XPath

EnhancedDefinition

Class

Codes

Pattern

OBWriteFundsConfirmationResponse

 

OBWriteFundsConfirmationResponse

 

OBWriteFundsConfirmationResponse

 

 

Data

1..1

OBWriteFundsConfirmationResponse/Data

 

OBWriteFundsConfirmationResponse/Data

 

 

FundsAvailableResult

0..1

OBWriteFundsConfirmationResponse/Data/FundsAvailableResult

Result of a funds availability check.

OBWriteFundsConfirmationResponse/Data/FundsAvailableResult

 

 

FundsAvailableDateTime

1..1

OBWriteFundsConfirmationResponse/Data/FundsAvailableResult/FundsAvailableDateTime

Date and time at which the funds availability check was generated.

DateTime

 

 

FundsAvailable

1..1

OBWriteFundsConfirmationResponse/Data/FundsAvailableResult/FundsAvailable

Flag to indicate the availability of funds given the Amount in the consent request.

Boolean

 

 

SupplementaryData

0..1

OBWriteFundsConfirmationResponse/Data/SupplementaryData

Additional information that can not be captured in the structured fields and/or any other specific block.

OBSupplementaryData

 

 

4.  Swagger Code

The swagger code for the International Payment Consents API can be found on this link.

5. Usage Examples 

...

5.1  POST /international-payment-consents

...

5.1.1 Request

POST /international-payment-consents

Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL

x-idempotency-key: XYZ.51403.MLT.30

x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=..G1rrM18vVYBmdmRurS6nIR1yFHR8bGZyIJdvaB5nKGRvm35hTr==

x-fapi-auth-date: Tue, 18 Mar 2020 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": {
    "ReadRefundAccount": "No",
    "Initiation": {
    "InstructionIdentification": "0616I029",
      "EndToEndIdentification": "20190616B002",
      "LocalInstrument": " BH.OBF.DNS ",
      "InstructionPriority": "Normal",
      "ChargeBearer": "BorneByCreditor",
      "CurrencyOfTransfer": "BHD",
      "DestinationCountryCode": "BH",
      "InstructedAmount": {
        "Amount": "5.60",
        "Currency": "BHD"
      },
      "ExchangeRateInformation": {
        "UnitCurrency": "USD",
        "ExchangeRate": 2.65,
        "RateType": "Actual",
        "ContractIdentification": "FEC"
      },
      "DebtorAccount": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": "BH10CBBU00100000008876",
        "Name": "Albert John",
      },
      "Creditor": {
        "Name": "Daniel d’souza",
        "PostalAddress": {
          "AddressType": "Business",
          "AddressLine": "ABC Bank, Diplomatic Area”

          “StreetName”: “Al Barsha”

          "BuildingNumber": "27",
          "PostCode": "317",
          "TownName": "Manama",
          "CountySubDivision": "Manama”             

          "Country": "BH",     
        }
      },

"CreditorAgent": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": "USU00100000008984736",
        "Name": "Joseph Niel",
        "PostalAddress": {
          "AddressType": "Business",  

          "AddressLine": "Batelco Headquarters”

          “StreetName”: “Acacia Avenue”

          "BuildingNumber": "27",
          "PostCode": "3122",
          "TownName": "Manama",
          "CountySubDivision": "Manama”             

          "Country": "BH",     
        }
      },
      "CreditorAccount": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": “USU0010000000667346",
        "Name": "Daniel d’souza ",
      },
      "RemittanceInformation": {
        "RemittanceDescription": "External Ops Code 34251",
        "Reference": "XYZ-101"
      },
   

"Authorisation": {
      "AuthorisationType": "Single",
      "CompletionDateTime": "2020-03-19T06:17:39.597+03:00"
    },
    "SCASupportData": {
      "RequestedSCAExemptionType": “TO_BE_CONFIRMED ",

         "AppliedAuthenticationApproach": "SCA",
      "ReferencePaymentOrderId": "936427-2"
    }

  },

 "Risk": {

    "PaymentContextCode": "BillPayment",
    "MerchantCategoryCode": "002345",
    "MerchantCustomerIdentification": "0023456789",
    "DeliveryAddress": {
         "AddressLine": "ABC Bank, Diplomatic Area”

          “StreetName”: “Al Barsha”

          "BuildingNumber": "27",
          "PostCode": "317",
          "TownName": "Manama",
          "CountySubDivision": "Manama”             

          "Country": "BH",     
             },
    }

...

5.1.2 Response

201 Created

x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=

x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f

Content-Type: application/json

{
  "Data": {
    "ConsentId": "723852",
    "CreationDateTime": "2020-03-19T06:17:39.598+03:00",
    "Status": "Authorised",
    "StatusUpdateDateTime": "2020-03-19T06:17:39.598+03:00",
    "ReadRefundAccount": "No",
    "CutOffDateTime": "2020-03-19T06:17:39.598+03:00",
    "ExpectedExecutionDateTime": "2020-03-19T06:17:39.598+03:00",
    "ExpectedSettlementDateTime": "2020-03-19T06:17:39.598+03:00",
    "Charges": [
      {
        "ChargeBearer": "BorneByCreditor",
        "Type": "TO_BE_CONFIRMED",
        "Amount": {
          "Amount": "2.41",
          "Currency": "BHD"
        }
      }
    ],
    
    "ExchangeRateInformation": {
      "UnitCurrency": "USD",
      "ExchangeRate": 2.65,
      "RateType": "Actual",
      "ContractIdentification": "FEC",
      "ExpirationDateTime": "2020-03-19T06:17:39.598+03:00"
    },

    "Initiation": {
      "InstructionIdentification": "0616I029",
      "EndToEndIdentification": "20190616B002",
      "LocalInstrument": “BH.OBF.DNS ",
      "InstructionPriority": "Normal",
      "ChargeBearer": "BorneByCreditor",
      "CurrencyOfTransfer": "BHD",
      "DestinationCountryCode": "BH",
      "InstructedAmount": {
        "Amount": "5.60",
        "Currency": "BHD"
      },

  "ExchangeRateInformation": {
        "UnitCurrency": "USD",
        "ExchangeRate": 2.65,
        "RateType": "Actual",
        "ContractIdentification": "FEC"
      },

"DebtorAccount": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": "BH10CBBU00100000008876",
        "Name": "Albert John",
      },
      "Creditor": {
        "Name": "Daniel d’souza",
        "PostalAddress": {
          "AddressType": "Business",
          "AddressLine": "ABC Bank, Diplomatic Area”

          “StreetName”: “Al Barsha”

          "BuildingNumber": "27",
          "PostCode": "317",
          "TownName": "Manama",
          "CountySubDivision": "Manama”             

          "Country": "BH",            },
        }
      },

  "CreditorAgent": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": "USU00100000008984736",
        "Name": "Joseph Niel",
        "PostalAddress": {
          "AddressType": "Business",

          "AddressLine": "Batelco Headquarters”

          “StreetName”: “Acacia Avenue”

          "BuildingNumber": "27",
          "PostCode": "3122",
          "TownName": "Manama",
          "CountySubDivision": "Manama”             

          "Country": "BH",     
      },

"CreditorAccount": {
        "SchemeName": "BH.OBF.IBAN",
        "Identification": " USU0010000000667346",
        "Name": "Daniel d’souza ",
      },
      "RemittanceInformation": {
        "RemittanceDescription": "External Ops Code 34251",
        "Reference": "XYZ-101"
      },
    },
    "Authorisation": {
      "AuthorisationType": "Single",
      "CompletionDateTime": "2020-03-19T06:17:39.598+03:00"
    },
    "SCASupportData": {
      "RequestedSCAExemptionType": " TO_BE_CONFIRMED ",
      "AppliedAuthenticationApproach": "SCA",
      "ReferencePaymentOrderId": "936427-2"
    }

  },
  "Risk": {
    "PaymentContextCode": "BillPayment",
    "MerchantCategoryCode": "002345",
    "MerchantCustomerIdentification": "0023456789",
    "DeliveryAddress": {
      "AddressLine": "ABC Bank, Diplomatic Area”

      “StreetName”: “Al Barsha”

      "BuildingNumber": "27",
      "PostCode": "317",
      "TownName": "Manama",
      "CountySubDivision": "Manama”             

      "Country": "BH",      }
       },
  "Links": {
    "Self": "www.TBC.com"
  },
  "Meta": {
    "TotalPages": 01,
    "FirstAvailableDateTime": "2020-03-19T09:10:17.596+03:00",
    "LastAvailableDateTime": "2020-03-19T09:10:17.596+03:00"
  }
}

...

5.2  GET / international-payment-consents/{ConsentId}/funds-confirmation

...

5.2.1 Request

GET/ international-payment-consents/723852/funds-confirmation

Authorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL

x-fapi-auth-date: Tue, 18 Mar 2020 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

...

5.2.2 Response

200 OK

x-jws-signature: LMlmPSqzISEpar72ce5deMGue4RsZMDnZYG1bW6hdPlvriZ=

x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f

Content-Type: application/json

...