Παραδείγματα
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια υποβληθείσα αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια υποβληθείσα αλληλεπίδραση Open Banking (response.gatewayCode = SUBMITTED)
{
"amount":82113.13,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-08-17T09:35:27.250Z",
"currency":"GBP",
"customer":{
"email":"John@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
},
"id":"992608474",
"lastUpdatedTime":"2020-08-17T09:36:04.146Z",
"lineOfBusiness":"AIR_TICKETS",
"merchant":"TESTMERCHANT1",
"merchantAmount":82113.13,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"result":"SUCCESS",
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"John@example.com",
"firstName":"John",
"lastName":"Doe"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"12345XXX-XXXX-4156-XXXX-f6eeef0478cf"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"INITIATED",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"RETURNED_TO_MERCHANT",
"timeInitiated":"2020-08-17T09:35:27.272Z",
"timeRedirected":"2020-08-17T09:35:59.967Z",
"timeReturned":"2020-08-17T09:36:04.061Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-06f552c44de094aca21ee0abdf82303b",
"returnUrl":"<hostname>/apmDemoApp/complete.html"
},
"customer":{
"email":"John@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"lineOfBusiness":"AIR_TICKETS",
"merchant":" TESTMERCHANT1",
"order":{
"amount":82113.13,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-08-17T09:35:27.250Z",
"currency":"GBP",
"id":"992608474",
"lastUpdatedTime":"2020-08-17T09:36:04.146Z",
"merchantAmount":82113.13,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"status":"INITIATED",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"SUBMITTED"
},
"result":"SUCCESS",
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"12345XXX-XXXX-4156-XXXX-f6eeef0478cf"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-08-17T09:36:04.146Z",
"timeOfRecord":"2020-08-17T09:35:27.270Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":82113.13,
"currency":"GBP",
"id":"106172951",
"receipt":"162c0482b774b3e1",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια εγκεκριμένη αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα της απόκρισης Retrieve Transaction που εμφανίζει μια εγκεκριμένη αλληλεπίδραση Open Banking (response.gatewayCode = APPROVED)
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-24T01:01:09.584Z",
"currency":"GBP",
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"id":"86f293d3-1eb5-4003-9f30-7d9fbe7f1384",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-24T01:01:46.769Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff "
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"CAPTURED",
"taxAmount":10.47,
"totalAuthorizedAmount":123.46,
"totalCapturedAmount":123.46,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeCompleted":"2020-06-24T01:01:10.007Z",
"timeInitiated":"2020-06-24T01:01:09.599Z",
"timeRedirected":"2020-06-24T01:01:09.705Z",
"timeReturned":"2020-06-24T01:01:09.991Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-9099d773edb0e2d3d1e86c4bd9d9b867",
"returnUrl":"<hostname>/api/documentation/integrationGuidelines/index.html"
},
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-24T01:01:09.584Z",
"currency":"GBP",
"id":"86f293d3-1eb5-4003-9f30-7d9fbe7f1384",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-24T01:01:46.769Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"shippingAndHandlingAmount":4.99,
"status":"CAPTURED",
"taxAmount":10.47,
"totalAuthorizedAmount":123.46,
"totalCapturedAmount":123.46,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"APPROVED"
},
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff "
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-24T01:01:46.769Z",
"timeOfRecord":"2020-06-24T01:01:09.596Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"1",
"reference":"sample",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια εκκρεμή αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια εκκρεμή αλληλεπίδραση Open Banking (response.gatewayCode = PENDING)
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-26T07:09:16.846Z",
"currency":"GBP",
"customer":{
"email":"johmith@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36"
},
"id":"888190454",
"item":[
{
"detail":{
"unitTaxRate":0
},
"name":"Spud",
"quantity":1,
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item2",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-26T07:10:57.230Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@example.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"CAPTURED",
"taxAmount":10.47,
"totalAuthorizedAmount":123.46,
"totalCapturedAmount":123.46,
"totalRefundedAmount":0,
"transaction":[
{
"browserPayment":{
"interaction":{
"status":"RETURNED_TO_MERCHANT",
"timeInitiated":"2020-06-26T07:09:16.864Z",
"timeRedirected":"2020-06-26T07:10:53.329Z",
"timeReturned":"2020-06-26T07:11:03.827Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-65318d39a0c3b8000f07b7939561b819",
"returnUrl":"<hostname>/apmDemoApp/complete.html"
},
"customer":{
"email":"johmith@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-26T07:09:16.846Z",
"currency":"GBP",
"id":"888190454",
"item":[
{
"detail":{
"unitTaxRate":0
},
"name":"Spud",
"quantity":1,
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item2",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-26T07:10:57.230Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"shippingAndHandlingAmount":4.99,
"status":"CAPTURED",
"taxAmount":10.47,
"totalAuthorizedAmount":123.46,
"totalCapturedAmount":123.46,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"PENDING"
},
"result":"PENDING",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@example.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-26T07:10:57.230Z",
"timeOfRecord":"2020-06-26T07:09:16.861Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"148341288",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια μη υποστηριζόμενη αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια αλληλεπίδραση Open Banking όπου response.gatewayCode = NOT_SUPPORTED
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:04:16.222Z",
"currency":"GBP",
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"id":"575d3ae0-2b28-4a68-892e-688ae7e3d344",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:04:03.364Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeCompleted":"2020-06-11T07:04:16.708Z",
"timeInitiated":"2020-06-11T07:04:16.234Z",
"timeRedirected":"2020-06-11T07:04:15.257Z",
"timeReturned":"2020-06-11T07:04:16.679Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-bcd3a9b079f6a66581c3429dcbec386b",
"returnUrl":"<hostname>/api/documentation/integrationGuidelines/index.html"
},
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:04:16.222Z",
"currency":"GBP",
"id":"575d3ae0-2b28-4a68-892e-688ae7e3d344",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:04:03.364Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"shippingAndHandlingAmount":4.99,
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"NOT_SUPPORTED"
},
"result":"FAILURE",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-11T07:04:03.364Z",
"timeOfRecord":"2020-06-11T07:04:16.232Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"1",
"reference":"sample",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια αλληλεπίδραση Open Banking για την οποία έχει λήξει το χρονικό όριο
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια αλληλεπίδραση Open Banking για την οποία έχει λήξει το χρονικό όριο (response.gatewayCode = TIMED_OUT)
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-26T07:17:48.608Z",
"currency":"GBP",
"customer":{
"email":"johmith@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36"
},
"id":"246119218",
"item":[
{
"detail":{
"unitTaxRate":0
},
"name":"Spud",
"quantity":1,
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item2",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-26T07:18:27.894Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@example.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeCompleted":"2020-06-26T07:18:39.485Z",
"timeInitiated":"2020-06-26T07:17:49.654Z",
"timeRedirected":"2020-06-26T07:18:18.595Z",
"timeReturned":"2020-06-26T07:18:39.439Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-bd0d14660fc5bd0a98578a73e83713cd",
"returnUrl":"<hostname>/apmDemoApp/complete.html"
},
"customer":{
"email":"johmith@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-26T07:17:48.608Z",
"currency":"GBP",
"id":"246119218",
"item":[
{
"detail":{
"unitTaxRate":0
},
"name":"Spud",
"quantity":1,
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item2",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-26T07:18:27.894Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"shippingAndHandlingAmount":4.99,
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"TIMED_OUT"
},
"result":"FAILURE",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@example.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-26T07:18:27.894Z",
"timeOfRecord":"2020-06-26T07:17:49.641Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"354434408",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια αλληλεπίδραση Open Banking στην οποία τα κεφάλαια είναι ανεπαρκή
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια αλληλεπίδραση Open Banking όπου response.gatewayCode = INSUFFICIENT_FUNDS
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:04:25.661Z",
"currency":"GBP",
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"id":"38de9737-f394-484e-86ce-a6df45416a61",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:04:13.889Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeCompleted":"2020-06-11T07:04:26.110Z",
"timeInitiated":"2020-06-11T07:04:25.673Z",
"timeRedirected":"2020-06-11T07:04:25.798Z",
"timeReturned":"2020-06-11T07:04:26.079Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-dc04c5638e296c6fc3b2905a0607bbf9",
"returnUrl":"<hostname>/api/documentation/integrationGuidelines/index.html"
},
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:04:25.661Z",
"currency":"GBP",
"id":"38de9737-f394-484e-86ce-a6df45416a61",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:04:13.889Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"shippingAndHandlingAmount":4.99,
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"INSUFFICIENT_FUNDS"
},
"result":"FAILURE",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-11T07:04:13.889Z",
"timeOfRecord":"2020-06-11T07:04:25.670Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"1",
"reference":"sample",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια απορριφθείσα αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια απορριφθείσα αλληλεπίδραση Open Banking όπου response.gatewayCode = DECLINED
{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:06:37.862Z",
"currency":"GBP",
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"id":"800b8d34-770d-4135-a1a4-0afe64c96352",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:06:24.923Z",
"merchant":"TESTMERCHANT1",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"shippingAndHandlingAmount":4.99,
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0,
"transaction":
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeCompleted":"2020-06-11T07:06:38.269Z",
"timeInitiated":"2020-06-11T07:06:37.871Z",
"timeRedirected":"2020-06-11T07:06:37.983Z",
"timeReturned":"2020-06-11T07:06:38.241Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-6c56d32fad0f0f11df57409b9728cb5c",
"returnUrl":"<hostname>/api/documentation/integrationGuidelines/index.html"
},
"device":{
"browser":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":123.46,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-06-11T07:06:37.862Z",
"currency":"GBP",
"id":"800b8d34-770d-4135-a1a4-0afe64c96352",
"item":[
{
"brand":"MC",
"category":"NA",
"detail":{
"unitDiscountRate":0,
"unitTaxRate":0
},
"name":"item0",
"quantity":1,
"sku":"sku",
"unitDiscountAmount":3,
"unitPrice":21,
"unitTaxAmount":0.47
},
{
"detail":{
"unitTaxRate":0
},
"name":"item1",
"quantity":2,
"unitDiscountAmount":2,
"unitPrice":47,
"unitTaxAmount":5
}
],
"itemAmount":115,
"lastUpdatedTime":"2020-06-11T07:06:24.923Z",
"merchantAmount":123.46,
"merchantCurrency":"GBP",
"reference":"sample",
"shippingAndHandlingAmount":4.99,
"status":"FAILED",
"taxAmount":10.47,
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"DECLINED"
},
"result":"FAILURE",
"risk":{
"response":{
"gatewayCode":"ACCEPTED"
}
},
"shipping":{
"address":{
"city":"London",
"company":"ABC",
"country":"GBR",
"postcodeZip":"90001",
"stateProvince":"ENG",
"street":"2nd Main",
"street2":"lane 2"
},
"contact":{
"email":"John@gmail.com",
"firstName":"John",
"lastName":"Doe",
"mobilePhone":"9999999999",
"phone":"9999999999"
},
"method":"SAME_DAY"
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-06-11T07:06:24.923Z",
"timeOfRecord":"2020-06-11T07:06:37.869Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":123.46,
"currency":"GBP",
"id":"1",
"reference":"sample",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια αλληλεπίδραση Open Banking στην οποία η ταυτοποίηση απέτυχε
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια αλληλεπίδραση Open Banking όπου response.gatewayCode = AUTHENTICATION_FAILED
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeInitiated":"2020-11-20T05:07:28.134Z",
"timeRedirected":"2020-11-20T05:07:34.498Z",
"timeReturned":"2020-11-20T05:07:43.449Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-b37b6e71a76bfa5f3847349684297033",
"returnUrl":"<hostname>/apmDemoApp/complete.html"
},
"customer":{
"email":"John@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.193 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":85116.16,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-11-20T05:07:28.085Z",
"currency":"GBP",
"id":"408124232",
"lastUpdatedTime":"2020-11-20T05:07:46.524Z",
"merchantAmount":85116.16,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"status":"FAILED",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"AUTHENTICATION_FAILED"
},
"result":"FAILURE",
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@yahoo.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-11-20T05:07:46.524Z",
"timeOfRecord":"2020-11-20T05:07:28.130Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":85116.16,
"currency":"GBP",
"id":"162988232",
"receipt":"16491f04ec662b0a",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
Δείγμα απόκρισης του αιτήματος Retrieve Transaction για μια ακυρωμένη αλληλεπίδραση Open Banking
Ακολουθεί ένα παράδειγμα απόκρισης του αιτήματος Retrieve Transaction που εμφανίζει μια αλληλεπίδραση Open Banking όπου response.gatewayCode = CANCELLED
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeInitiated":"2020-11-20T05:17:33.076Z",
"timeRedirected":"2020-11-20T05:17:40.315Z",
"timeReturned":"2020-11-20T05:17:47.612Z"
},
"operation":"PAY",
"redirectUrl":"<hostname>/bpui/ob/out/BP-fdc97e608a425ec6cc535ae6a8dd9063",
"returnUrl":"<hostname>/apmDemoApp/complete.html"
},
"customer":{
"email":"John@example.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.193 Safari/537.36"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"TESTMERCHANT1",
"order":{
"amount":86117.17,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2020-11-20T05:17:33.039Z",
"currency":"GBP",
"id":"849804618",
"lastUpdatedTime":"2020-11-20T05:17:50.060Z",
"merchantAmount":86117.17,
"merchantCurrency":"GBP",
"reference":"TEST-SUCCEED",
"status":"FAILED",
"totalAuthorizedAmount":0,
"totalCapturedAmount":0,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"CANCELLED"
},
"result":"FAILURE",
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"johnsmith@yahoo.com",
"firstName":"Shipfirst",
"lastName":"McShiplast"
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"123456-xxxx-4dd4-b4f2-12234vgb43bff"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2020-11-20T05:17:50.060Z",
"timeOfRecord":"2020-11-20T05:17:33.073Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":86117.17,
"currency":"GBP",
"id":"921434587",
"receipt":"16491f91c5986259",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
Επιστροφές χρημάτων
Προαπαιτούμενα
Για την εκκίνηση ενός αιτήματος επιστροφής χρημάτων, ο <<paymentServiceProvider>> πρέπει να σας διαμορφώσει ώστε να έχετε το δικαίωμα επιστροφή χρημάτων.
Για να χρησιμοποιήσετε επιστροφές χρημάτων, χρησιμοποιήστε την έκδοση 1.3.0 JS-SDK που υποστηρίζεται από την έκδοση 68 του WSAPI.
Οι επιστροφές χρημάτων υποστηρίζονται μόνο για εγχώριες συναλλαγές. Μπορείτε να υποβάλετε αιτήματα επιστροφής χρημάτων μέσω της πράξης Refund ή χρησιμοποιώντας την πύλη Merchant Administration. Για τις πληρωμές Open Banking, μπορείτε να επιστρέψετε εν μέρει ή πλήρως τις πληρωμές που έχουν διεκπεραιωθεί για τις δεσμευμένες συναλλαγές. Οι πληρωμές μεταφοράς Open Banking δεν υποστηρίζουν επιπλέον πιστωτικό υπόλοιπο.
Πληροφορίες τακτοποίησης (settlement)
Για να δείτε τις λεπτομέρειες της τακτοποίησης συναλλαγής με Open Banking Bank Transfer, ανακτήστε τις λεπτομέρειες παραγγελίας/συναλλαγής χρησιμοποιώντας τις πράξεις Retrieve Order/Retrieve Transaction και ελέγξτε το πεδίο transaction.receipt για τον αριθμό αναφοράς. Ο ίδιος αριθμός αναφοράς θα εμφανίζεται στον πληρωτή στην απόδειξη πληρωμής.
Ειδοποιήσεις Webhook
Η συνδρομή στις ειδοποιήσεις Webhook σας δίνει τη δυνατότητα να λαμβάνετε ειδοποιήσεις στο σύστημά σας όταν δημιουργείται ή ενημερώνεται μια συναλλαγή για μια παραγγελία στην πύλη. Αυτό σας δίνει επίσης τη δυνατότητα να ενημερώσετε το σύστημα εμπόρου αναλόγως. Η ειδοποίηση Webhook περιέχει την απόκριση της πράξης Retrieve Transaction.
Λεπτομέρειες ειδοποιήσεων Webhook
Δείγμα απόκρισης Webhook
{
"browserPayment":{
"interaction":{
"status":"COMPLETED",
"timeInitiated":"2021-02-18T10:59:26.772Z",
"timeRedirected":"2021-02-18T10:59:31.236Z",
"timeReturned":"2021-02-18T11:00:01.577Z"
},
"operation":"PAY",
"redirectUrl":"https://lloydsbankpayfrombank.gateway.mastercard.com/bpui/ob/out/BP-5da80e52dd990b1970ae8bdfc6fddb36",
"returnUrl":"https://prd-mastercard.airbakery.eu/Return.aspx"
},
"customer":{
"email":"johnsmith@yahoo.com"
},
"device":{
"browser":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.150 Safari/537.36 Edg/88.0.705.68",
"ipAddress":"101.00.100.00"
},
"gatewayEntryPoint":"WEB_SERVICES_API",
"merchant":"AIRBAKERY",
"order":{
"amount":5.00,
"chargeback":{
"amount":0,
"currency":"GBP"
},
"creationTime":"2021-02-18T10:59:26.728Z",
"currency":"GBP",
"id":"TESTORD12345",
"lastUpdatedTime":"2021-02-18T11:00:31.905Z",
"merchantAmount":5.00,
"merchantCurrency":"GBP",
"status":"CAPTURED",
"totalAuthorizedAmount":5.00,
"totalCapturedAmount":5.00,
"totalRefundedAmount":0
},
"response":{
"gatewayCode":"APPROVED"
},
"result":"SUCCESS",
"risk":{
"response":{
"gatewayCode":"ACCEPTED",
"review":{
"decision":"NOT_REQUIRED",
"note":""
},
"rule":[
{
"data":"100.00.100.01",
"name":"MSO_IP_ADDRESS_RANGE",
"recommendation":"NO_ACTION",
"type":"MSO_RULE"
},
{
"data":"GBR",
"name":"MSO_IP_COUNTRY",
"recommendation":"NO_ACTION",
"type":"MSO_RULE"
}
]
}
},
"sourceOfFunds":{
"provided":{
"openBankingBankTransfer":{
"aspspId":"12345-23abc-a2g-a8e7-5653886af4"
}
},
"type":"OPEN_BANKING_BANK_TRANSFER"
},
"timeOfLastUpdate":"2021-02-18T11:00:31.905Z",
"timeOfRecord":"2021-02-18T10:59:26.768Z",
"transaction":{
"acquirer":{
"id":"OPEN_BANKING",
"merchantId":"Lloyds"
},
"amount":5.00,
"currency":"GBP",
"id":" TESTTRX12345",
"receipt":"52345667731732aa",
"source":"INTERNET",
"stan":"0",
"type":"PAYMENT"
},
"version":"<latest_gateway_version>"
}
Περιγραφή απόκρισης Webhook
Ο παρακάτω πίνακας παρέχει περιγραφή για κάθε στοιχείο στην απόκριση Webhook
Στοιχείο |
Περιγραφή |
Τιμές |
| BrowserPayment |
Πληροφορίες που απαιτούνται από την πύλη για τη διαχείριση των αλληλεπιδράσεων με τον ιστότοπο ενός παρόχου υπηρεσιών πληρωμής μέσω browser. |
- |
| Interaction |
Παρέχει λεπτομέρειες σχετικά με την αλληλεπίδραση του συστήματός σας και του συστήματος του παρόχου κατά την έναρξη της πληρωμής μέσω browser, ανακατευθύνοντας τον browser του πελάτη στο σύστημα του παρόχου, πίσω στον ιστότοπο του εμπόρου, και ολοκληρώνοντας την πληρωμή μέσω browser |
- |
| Status |
Η κατάσταση της αλληλεπίδρασης μεταξύ του συστήματος του εμπόρου και του συστήματος του παρόχου υπηρεσιών πληρωμής. |
COMPLETED: Αυτή η πληρωμή μέσω browser έχει ολοκληρωθεί, δηλαδή η πύλη έχει ενημερωθεί για το αποτέλεσμα πληρωμής.
INITIATED: Αυτή η πληρωμή μέσω browser εκκινήθηκε με επιτυχία.
REDIRECTED_TO_PROVIDER: Ο browser του πληρωτή ανακατευθύνθηκε στον ιστότοπο του παρόχου υπηρεσιών πληρωμής.
RETURNED_TO_MERCHANT: Ο browser του πληρωτή ανακατευθύνθηκε πίσω από τον ιστότοπο του παρόχου υπηρεσιών πληρωμής στον ιστότοπου του εμπόρου.
|
| Time Initiated |
Η ημερομηνία και η ώρα που εκκινήθηκε η πληρωμή μέσω browser. |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T10:59:26.772Z |
| Time Redirected |
Η ημερομηνία και η ώρα λήψης του browser του πελάτη από τον ιστότοπο του εμπόρου και ανακατευθύνθηκε στον ιστότοπο του παρόχου υπηρεσιών πληρωμής. |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T10:59:31.236Z |
| Time Returned |
Η ημερομηνία και η ώρα λήψης του browser του πελάτη από τον ιστότοπο του παρόχου και ανακατευθύνθηκε πίσω στον ιστότοπο του εμπόρου. |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T11:00:01.577Z |
| Operation |
Ο τύπος συναλλαγής που δημιουργήθηκε για αυτήν την πληρωμή. |
PAY |
| Redirect URL |
Η διεύθυνση URL εντός του ιστότοπου του εμπόρου όπου ανακατευθύνεται ο browser του πληρωτή όταν ο πληρωτής επιλέγει τον τρόπο πληρωμής Open Banking Bank Transfer. |
- |
| Return URL |
Η διεύθυνση URL στην οποία θέλετε ο browser του πληρωτή να ανακατευθύνεται με την ολοκλήρωση της πληρωμής στον ιστότοπο του παρόχου υπηρεσιών πληρωμής. Η ίδια διεύθυνση ανακατεύθυνσης URL θα χρησιμοποιηθεί από την πύλη για να ανακατευθύνει τον browser του πληρωτή ανεξάρτητα από την επιτυχία ή όχι της πληρωμής. Ο έμπορος μπορεί να δημιουργήσει μια λύση για να θέτει ερώτημα σχετικά με την απόκριση επιτυχίας ή για να εμφανίσει συγκεκριμένο μήνυμα στον πληρωτή. |
- |
| Customer |
Πληροφορίες σχετικά με τον πελάτη. Για παράδειγμα τα στοιχεία επικοινωνίας, η διεύθυνση email, κ.λπ. |
- |
| Email |
Η διεύθυνση email του πελάτη. Διασφαλίζει ότι η διεύθυνση email είναι μεγαλύτερη από 3 χαρακτήρες και συμμορφώνεται με ένα γενναιόδωρο υποσύνολο έγκυρων διευθύνσεων email RFC 2822. |
Για παράδειγμα - JohnDoe@yahoo.com |
| Device |
Πληροφορίες σχετικά με τη συσκευή που χρησιμοποιεί ο πληρωτής για αυτήν τη συναλλαγή |
- |
| Browser |
Η κεφαλίδα User-Agent του browser που χρησιμοποίησε ο πελάτης για να υποβάλει την παραγγελία |
Για παράδειγμα - “Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.150 Safari/537.36 Edg/88.0.705.68" |
| IP Address |
Η διεύθυνση IP της συσκευής που χρησιμοποιείται από τον πληρωτή, σε μορφή nnn.nnn.nnn.nnn |
- |
| GatewayEntryPoint |
Το περιβάλλον εργασίας μέσω του οποίου υποβάλλεται η συναλλαγή στην πύλη. |
Ορίζεται σε "WEB_SERVICE_API" ως προεπιλογή |
| Merchant |
Το μοναδικό αναγνωριστικό που σας εκδόθηκε από τον πάροχο υπηρεσιών πληρωμής που χρησιμοποιείτε. Με άλλα λόγια, το "ID εμπόρου". |
Όνομα εμπόρου |
| Order |
Πληροφορίες σχετικά με την παραγγελία που συσχετίζεται με αυτήν τη συναλλαγή. |
- |
| Amount |
Το συνολικό ποσό για την παραγγελία. Πρόκειται για το καθαρό ποσό συν οποιοδήποτε πρόσθετο τέλος. Αν δίνετε τυχόν μερικά ποσά, τότε το άθροισμα αυτών των ποσών (order.itemAmount, order.taxAmount, order.shippingAndHandlingAmount, order.cashbackAmount, order.gratuityAmount), μείον το order.discountAmount πρέπει να ισούται με το καθαρό ποσό. |
Για παράδειγμα - 5.00 |
| Chargeback |
Δεν ισχύει για Open Banking Bank Transfer, ωστόσο το ποσό και το νόμισμα θα πρέπει να καθοριστούν ως εξής |
- |
| Amount |
- |
Μηδέν |
| Currency |
- |
GBP |
| Creation Time |
Η ημερομηνία και η ώρα από την πύλη που δημιουργήθηκε η παραγγελία |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T10:59:26.728Z |
| Currency |
Το νόμισμα της παραγγελίας που εκφράζεται ως αλφαβητικός κωδικός κατά ISO 4217 |
GBP |
| ID |
Ένα μοναδικό αναγνωριστικό για αυτή την παραγγελία, ώστε να διακρίνεται από άλλη παραγγελία που δημιουργείτε. Χρησιμοποιήστε αυτό το αναγνωριστικό όταν αναφέρεστε σε αυτήν την παραγγελία σε επακόλουθες συναλλαγές και διαδικασίες ανάκτησης. Αυτή η τιμή πρέπει να είναι μοναδική για κάθε παραγγελία που δημιουργείται από το προφίλ εμπόρου σας. |
Το ID παραγγελίας που δημιουργείται |
| Last updated time |
Η ημερομηνία και η ώρα από την πύλη που ενημερώθηκε τελευταία φορά η παραγγελία Μια χρονική στιγμή εκφρασμένη σε μορφή ημερομηνίας + ώρας ISO8601 - "YYYY-MM-DDThh:mm:ss.SSSZ" |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T11:00:31.905Z |
| Merchant amount |
Το συνολικό ποσό για την παραγγελία |
Για παράδειγμα - 5.00 |
| Merchant currency |
Το νόμισμα της παραγγελίας που εκφράζεται ως αλφαβητικός κωδικός κατά ISO 4217 |
GBP |
| Status |
Η τρέχουσα πορεία αυτής της παραγγελίας στη διαδικασίας πληρωμής. |
CANCELLED: Η αρχική συναλλαγή για αυτή την παραγγελία ακυρώθηκε με επιτυχία.
CAPTURED: Το εγκεκριμένο ποσό για αυτή την παραγγελία, εν μέρει, εν όλω, ή σε πιστωτικό υπόλοιπο, έχει δεσμευτεί με επιτυχία.
FAILED: Η πληρωμή δεν ήταν επιτυχής.
INITIATED: Μια πληρωμή που έχει εκκινηθεί επιτυχώς για αυτή την παραγγελία. Δεν έχει γίνει ακόμα πληρωμή.
|
| Total Authorized Amount |
Το ποσό που εγκρίθηκε επιτυχώς για αυτή την παραγγελία. |
Για Open Banking Bank Transfer θα πρέπει να είναι πάντα ίσο με το ποσό παραγγελίας. |
| Total Captured Amount |
Το ποσό που δεσμεύτηκε επιτυχώς για αυτή την παραγγελία. |
Για Open Banking Bank Transfer θα πρέπει να είναι πάντα ίσο με το ποσό παραγγελίας. |
| Total Refunded Amount |
Το ποσό που επιστράφηκε επιτυχώς για αυτή την παραγγελία. |
Για Open Banking Bank Transfer θα πρέπει να είναι πάντα μηδέν. |
| Response |
Η απόκριση της πύλης για αυτή τη συναλλαγή. |
- |
| Gateway Code |
Σύνοψη της επιτυχίας ή όχι της επιχείρησης. |
ACQUIRER_SYSTEM_ERROR: Παρουσιάστηκε σφάλμα στο σύστημα της τράπεζας εμπόρου κατά τη διεκπεραίωση αυτής της συναλλαγής.
APPROVED: Η συναλλαγή εγκρίθηκε
AUTHENTICATION_FAILED: Η ταυτοποίηση πληρωτή απέτυχε.
CANCELLED: Η συναλλαγή ακυρώθηκε από τον πληρωτή.
DECLINED: Η πράξη που ζητήθηκε δεν ήταν επιτυχής. Για παράδειγμα, μια πληρωμή απορρίφθηκε από τον εκδότη ή η ταυτοποίηση πληρωτή δεν μπόρεσε να ολοκληρωθεί με επιτυχία.
INSUFFICIENT_FUNDS: Η συναλλαγή απορρίφθηκε λόγω ανεπαρκών χρημάτων.
NOT_SUPPORTED: Ο τύπος συναλλαγή δεν υποστηρίζεται.
PENDING: Συναλλαγή σε εκκρεμότητα.
SUBMITTED: Η συναλλαγή δημιουργήθηκε με επιτυχία στην πύλη. Είτε αναμένει υποβολή στην τράπεζα εμπόρου είτε έχει υποβληθεί στην τράπεζα εμπόρου, αλλά η πύλη δεν έχει λάβει ακόμη απόκριση σχετικά με την επιτυχία ή μη της πληρωμής.
TIMED_OUT: Η πύλη έχει λήξει το χρονικό όριο του αιτήματος προς την τράπεζα εμπόρου επειδή δεν έλαβε απόκριση. Η εξαργύρωση πόντων δεν θα πρέπει να προσφέρεται στον πληρωτή.
UNKNOWN: Η συναλλαγή έχει υποβληθεί στην τράπεζα εμπόρου, αλλά η πύλη δεν μπόρεσε να μάθει για την επιτυχία ή μη της πληρωμής. Αν η πύλη μάθει, στη συνέχεια, για την επιτυχία της πληρωμής, θα ενημερώσει τον κωδικό απόκρισης.
UNSPECIFIED_FAILURE: Δεν ήταν δυνατή η διεκπεραίωση της συναλλαγής
|
| Results |
Ένα συνολικό αποτέλεσμα της πράξης υψηλού επιπέδου που δημιουργείται από το σύστημα. |
FAILURE: Η πράξη δεν έγινε αποδεκτή ή απορρίφθηκε από την πύλη, την τράπεζα εμπόρου ή τον εκδότη.
PENDING: Η πράξη βρίσκεται σε εξέλιξη ή εκκρεμεί διεκπεραίωση.
SUCCESS: Η πράξη διεκπεραιώθηκε με επιτυχία.
UNKNOWN: Το αποτέλεσμα της πράξης δεν είναι γνωστό.
|
| Risk |
Οι πληροφορίες που σχετίζονται με την εκτίμηση κινδύνου δεν ισχύουν για το Open Banking Bank Transfer. Αγνοήστε τις λεπτομέρειες σε αυτό το αντικείμενο. |
- |
| SourceOfFunds |
Πληροφορίες σχετικά με τον τύπο πληρωμής που έχει επιλεγεί από τον πληρωτή για αυτήν την πληρωμή και την πηγή των χρημάτων. |
- |
| Provided |
Πληροφορίες σχετικά με την πηγή των κεφαλαίων όταν παρέχονται απευθείας (σε αντίθεση με ένα token ή περίοδο λειτουργίας). |
- |
| Open Banking Bank Transfer |
Πρόσθετες λεπτομέρειες σχετικά με το Open Banking Bank Transfer, γνωστό και ως Open Banking Bank Transfer. |
- |
| ASPSP ID |
Αναγνωριστικό της τράπεζας του πληρωτή, επίσης γνωστό ως ASPSP (Account Servicing Payment Services Provider) |
- |
| Type |
Ο τρόπος πληρωμής που χρησιμοποιείται για αυτή την πληρωμή |
Open Banking Bank Transfer |
| TimeOfLastUpdated |
Η ημερομηνία και η ώρα από την πύλη που ενημερώθηκε τελευταία φορά η συναλλαγή. |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T11:00:31.905Z |
| TimeOfRecord |
Η ημερομηνία και η ώρα από την πύλη που δημιουργήθηκε τελευταία φορά η συναλλαγή. |
Για παράδειγμα, παρακάτω είναι ένα δείγμα τιμής για αναφορά της μορφής: 2021-02-18T10:59:26.768Z |
| Transaction |
Πληροφορίες για αυτή τη συναλλαγή. |
- |
| Acquirer |
Πληροφορίες για αυτή την τράπεζα εμπόρου. |
- |
| ID |
Το ID της τράπεζας εμπόρου που χρησιμοποιείται για τη διεκπεραίωση της συναλλαγής. |
Open Banking |
| Merchant ID |
Ένα αναγνωριστικό που αποδίδεται στον έμπορο από την τράπεζα εμπόρου. |
Lloyds |
| Amount |
Το συνολικό ποσό φόρου για τη συναλλαγή. |
Για παράδειγμα - 5.00 |
| Currency |
Το νόμισμα της συναλλαγής που εκφράζεται ως αλφαβητικός κωδικός κατά ISO 4217 |
GBP |
| ID |
Μοναδικό αναγνωριστικό αυτής της συναλλαγής ώστε να διακρίνεται από άλλη συναλλαγή στην παραγγελία. |
Το ID συναλλαγής που δημιουργείται. |
| Receipt |
Μια μοναδική αναφορά που δημιουργείται από την τράπεζα εμπόρου για μια συγκεκριμένη αλληλεπίδραση εμπόρου. |
Ο αριθμός αναφοράς που δημιουργείται για τον έμπορο. |
| Source |
Υποδεικνύει το κανάλι μέσω του οποίου λάβατε εξουσιοδότηση για την πληρωμή αυτής της παραγγελίας από τον πληρωτή |
INTERNET |
| STAN |
Ο αριθμός ελέγχου παρακολούθησης συστήματος (STAN) για τη συναλλαγή. |
Μηδέν |
| Type |
Υποδεικνύει τον τύπο της ενέργειας που πραγματοποιείται για την παραγγελία. |
PAYMENT |
| Version |
Η έκδοση του Web Services API στην οποία υποβλήθηκε το αίτημα. |
Προεπιλεγμένη έκδοση - 63 |
Δοκιμή της ενοποίησης Open Banking Bank Transfer
Το <<paymentGateway>> παρέχει έναν εξομοιωτή ενός δείγματος Open Banking Bank Transfer που σας επιτρέπει να δοκιμάζετε την ενοποίηση με δοκιμαστική τράπεζα και ποσά. Μόλις ολοκληρώσετε την ενοποίησή σας με το Open Banking JavaScript SDK, μπορείτε να εκτελέσετε δοκιμαστικές συναλλαγές χρησιμοποιώντας τα ποσά της δοκιμαστικής συναλλαγής με την τράπεζα Copernicium όπως φαίνεται στον παρακάτω πίνακα. Αν θέλετε να προχωρήσετε με τη δοκιμαστική τράπεζα Ozone Modelo, επιλέξτε το σενάριο (επιτυχία/αποτυχία) που θέλετε να δοκιμάσετε χρησιμοποιώντας τις επιλογές από την αναπτυσσόμενη λίστα στην οθόνη.
Σενάριο |
Ποσό συναλλαγής |
Κατάσταση συναλλαγής |
Κατάσταση παραγγελίας |
| Σενάρια επιτυχίας (προεπιλογή) |
80111.11 GBP |
SUBMITTED |
INITIATED |
| Σενάρια επιτυχίας (προεπιλογή) |
81112.12 GBP |
PENDING RESPONSE |
CAPTURED |
| Σενάρια επιτυχίας (προεπιλογή) |
92123.23 GBP |
APPROVED |
CAPTURED |
| Σενάρια αποτυχίας (προεπιλογή) |
83114.14 GBP |
UNSPECIFIED FAILURE |
FAILED |
| Άρνηση πρόσβασης |
85116.16 GBP |
AUTHENTICATION FAILED |
FAILED |
| Λήξη χρόνου αιτήματος συναλλαγής |
84115.15 GBP |
TIMED OUT |
FAILED |
| Η συναλλαγή ακυρώθηκε |
86117.17 GBP |
CANCELLED |
FAILED |
| Σενάρια αποτυχίας - λήξη χρονικού ορίου επεξεργασίας πληρωμών |
87118.18 GBP |
TIMED OUT |
FAILED |
| Μη επαρκή χρήματα |
88119.19 GBP |
INSUFFICIENT FUNDS |
FAILED |
| Μη έγκυρο ποσό |
89120.20 GBP |
NOT SUPPORTED |
FAILED |
| Μη έγκυρο νόμισμα |
89120.20 GBP |
NOT SUPPORTED |
FAILED |