{"items":[{"type":"link","label":"Card Payments","link":"/products/card-payments/openapi","routeSlug":"/products/card-payments/openapi","content":{"contentType":"overview","meta":{"name":"Card Payments"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/access/_bundle/products/card-payments/@v7/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/access/_bundle/products/card-payments/@v7/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"payload","title":"Payload","lang":"Payload"},{"key":"curl","title":"curl","lang":"curl"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"go","title":"Go","lang":"Go"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"csharp","title":"C#","lang":"C#"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Card Payments (7)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Take online payments with our Card Payments API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication header"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Authorization: {your_credentials}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Authorization: {your_credentials}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replace "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{your_credentials}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with your base64-encoded Basic Auth username and password given to your by your Worldpay Implementation Manager."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header for any request you send to our Card Payments API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accept/Content-Type header"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"Content-Type: application/vnd.worldpay.payments-v7+json\nAccept: application/vnd.worldpay.payments-v7+json\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Content-Type: application/vnd.worldpay.payments-v7+json\nAccept: application/vnd.worldpay.payments-v7+json\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our Card Payments API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"DNS whitelisting"},"children":[]}]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whitelist the following URLs:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://try.access.worldpay.com/"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://access.worldpay.com/"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please ensure you use DNS whitelisting, not explicit IP whitelisting."},"children":[]}]}]}]}],"sectionId":"/products/card-payments/openapi"}],"sectionId":"/products/card-payments/openapi"}]}]}},{"label":"Take a card payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/other/authorize","routeSlug":"/products/card-payments/openapi/other/authorize","metadata":{"seo":{"title":"Take a card payment","description":"Take online card payments using our Card Payments API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"authorize","name":"Take a card payment","isWebhook":false,"pointer":"/paths/~1cardPayments~1customerInitiatedTransactions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Take a card payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Take online card payments using our Card Payments API."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1cardPayments~1customerInitiatedTransactions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/customerInitiatedTransaction","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"]}},"schemaId":"components/schemas/customerInitiatedTransaction","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"],"pointer":"/paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cardPayments/customerInitiatedTransactions","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/customerInitiatedTransaction","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"]}},"responseCodes":["201","400","401","404","415","500"],"pointer":"/cardPayments/customerInitiatedTransactions","href":"other/authorize","openApiOperationId":"authorize","summary":"Take a card payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/customerInitiatedTransaction","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/customerInitiatedTransaction","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"]}},"examples":[{},{},{},{},{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"The payment authorization has been successfully created","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_354","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]}},"schemaId":"schema_354","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}],"pointer":"/paths/~1cardPayments~1customerInitiatedTransactions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_354","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_354","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID","paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/other/authorize"}],"panels":[]}]},"httpPath":"/cardPayments/customerInitiatedTransactions"},{"label":"Take a repeat card payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/other/recurring","routeSlug":"/products/card-payments/openapi/other/recurring","metadata":{"seo":{"title":"Take a repeat card payment","description":"Take online payments using our Card Payments API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"recurring","name":"Take a repeat card payment","isWebhook":false,"pointer":"/paths/~1cardPayments~1merchantInitiatedTransactions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Take a repeat card payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Take online payments using our Card Payments API."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1cardPayments~1merchantInitiatedTransactions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/merchantInitiatedTransaction","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"]}},"schemaId":"components/schemas/merchantInitiatedTransaction","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"],"pointer":"/paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/cardPayments/merchantInitiatedTransactions","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/merchantInitiatedTransaction","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"]}},"responseCodes":["201","400","401","404","415","500"],"pointer":"/cardPayments/merchantInitiatedTransactions","href":"other/recurring","openApiOperationId":"recurring","summary":"Take a repeat card payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/merchantInitiatedTransaction","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/merchantInitiatedTransaction","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"The payment authorization has been successfully created","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_355","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]}},"schemaId":"schema_355","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}],"pointer":"/paths/~1cardPayments~1merchantInitiatedTransactions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_355","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_355","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization","paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/other/recurring"}],"panels":[]}]},"httpPath":"/cardPayments/merchantInitiatedTransactions"},{"type":"group","label":"Manage payments","link":"/products/card-payments/openapi/manage-payments","routeSlug":"/products/card-payments/openapi/manage-payments","items":[{"label":"Settle for full amount","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/settle","routeSlug":"/products/card-payments/openapi/manage-payments/settle","metadata":{"seo":{"title":"Settle for full amount","description":"To receive all the funds from the customer, send us a settle request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"settle","name":"Settle for full amount","isWebhook":false,"pointer":"/paths/~1payments~1settlements~1full~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Settle for full amount","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"To receive all the funds from the customer, send us a settle request."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1settlements~1full~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1settlements~1full~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_settle","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"]}},"schemaId":"components/schemas/payments_settle","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"],"pointer":"/paths/~1payments~1settlements~1full~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/settlements/full/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_settle","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"]}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/settlements/full/{linkData}","href":"manage-payments/settle","openApiOperationId":"settle","summary":"Settle for full amount"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_settle","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_settle","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The payment settlement has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullSettle_response","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization"]}},"schemaId":"components/schemas/payments_fullSettle_response","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"aapplication/vnd.worldpay.payments-v7+json","mediaTypes":["aapplication/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"aapplication/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1settlements~1full~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_fullSettle_response","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullSettle_response","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["aapplication/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"aapplication/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/settle"}],"panels":[]}]},"httpPath":"/payments/settlements/full/{linkData}"},{"label":"Settle for partial amount","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/partialsettlement","routeSlug":"/products/card-payments/openapi/manage-payments/partialsettlement","metadata":{"seo":{"title":"Settle for partial amount","description":"To receive a portion of the funds of a payment, send us a partial settle request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"partialSettlement","name":"Settle for partial amount","isWebhook":false,"pointer":"/paths/~1payments~1settlements~1partials~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Settle for partial amount","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"To receive a portion of the funds of a payment, send us a partial settle request."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1settlements~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1settlements~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialSettle","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"]}},"schemaId":"components/schemas/payments_partialSettle","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"],"pointer":"/paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/settlements/partials/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialSettle","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"]}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/settlements/partials/{linkData}","href":"manage-payments/partialsettlement","openApiOperationId":"partialSettlement","summary":"Settle for partial amount"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_partialSettle","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialSettle","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code","paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The partial settlement has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialSettle_response","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization"]}},"schemaId":"components/schemas/payments_partialSettle_response","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1settlements~1partials~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_partialSettle_response","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialSettle_response","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/partialsettlement"}],"panels":[]}]},"httpPath":"/payments/settlements/partials/{linkData}"},{"label":"Refund full amount","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/refund","routeSlug":"/products/card-payments/openapi/manage-payments/refund","metadata":{"seo":{"title":"Refund full amount","description":"Send a refund request to return the full settled amount to your customer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"refund","name":"Refund full amount","isWebhook":false,"pointer":"/paths/~1payments~1settlements~1refunds~1full~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Refund full amount","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send a refund request to return the full settled amount to your customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" No request body is needed for this request."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_refund"}},"schemaId":"components/schemas/payments_refund","pointer":"/paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/settlements/refunds/full/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_refund"}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/settlements/refunds/full/{linkData}","href":"manage-payments/refund","openApiOperationId":"refund","summary":"Refund full amount"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_refund","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_refund"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The refund request has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization"]}},"schemaId":"components/schemas/payments_fullRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_fullRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/refund"}],"panels":[]}]},"httpPath":"/payments/settlements/refunds/full/{linkData}"},{"label":"Refund partial amount","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/partialrefund","routeSlug":"/products/card-payments/openapi/manage-payments/partialrefund","metadata":{"seo":{"title":"Refund partial amount","description":"Send a partial refund request to return a portion of the settled amount to your customer. Send the amount to refund and the authorization currency in the body."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"partialRefund","name":"Refund partial amount","isWebhook":false,"pointer":"/paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Refund partial amount","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Send a partial refund request to return a portion of the settled amount to your customer.\n Send the amount to refund and the authorization currency in the body."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialRefund","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement","paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"]}},"schemaId":"components/schemas/payments_partialRefund","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement","paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"],"pointer":"/paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/settlements/refunds/partials/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialRefund","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement","paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"]}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/settlements/refunds/partials/{linkData}","href":"manage-payments/partialrefund","openApiOperationId":"partialRefund","summary":"Refund partial amount"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_partialRefund","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement","paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialRefund","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement","paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The partial refund has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization"]}},"schemaId":"components/schemas/payments_partialRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_partialRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialRefund_response","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/partialrefund"}],"panels":[]}]},"httpPath":"/payments/settlements/refunds/partials/{linkData}"},{"label":"Cancel full authorization","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/cancel","routeSlug":"/products/card-payments/openapi/manage-payments/cancel","metadata":{"seo":{"title":"Cancel full authorization","description":"If you don't want to proceed with a payment, you can send a full cancel request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancel","name":"Cancel full authorization","isWebhook":false,"pointer":"/paths/~1payments~1authorizations~1cancellations~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel full authorization","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't want to proceed with a payment, you can send a full cancel request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You can only cancel a payment which is authorized. If the payment is settled, you must create a refund."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_cancel"}},"schemaId":"components/schemas/payments_cancel","pointer":"/paths/~1payments~1authorizations~1cancellations~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/authorizations/cancellations/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_cancel"}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/authorizations/cancellations/{linkData}","href":"manage-payments/cancel","openApiOperationId":"cancel","summary":"Cancel full authorization"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_cancel","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_cancel"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The cancellation request has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization"]}},"schemaId":"components/schemas/payments_fullCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_fullCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_fullCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/cancel"}],"panels":[]}]},"httpPath":"/payments/authorizations/cancellations/{linkData}"},{"label":"Cancel partial authorization","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/partialcancel","routeSlug":"/products/card-payments/openapi/manage-payments/partialcancel","metadata":{"seo":{"title":"Cancel partial authorization","description":"If you don't want to proceed with a payment, you can send a partial cancel request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"partialCancel","name":"Cancel partial authorization","isWebhook":false,"pointer":"/paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel partial authorization","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you don't want to proceed with a payment, you can send a partial cancel request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You can only cancel a payment which is authorized. If the payment is settled, you must create a refund."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialCancel","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"schemaId":"components/schemas/payments_partialCancel","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"],"pointer":"/paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/authorizations/cancellations/partials/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialCancel","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/authorizations/cancellations/partials/{linkData}","href":"manage-payments/partialcancel","openApiOperationId":"partialCancel","summary":"Cancel partial authorization"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_partialCancel","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialCancel","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The partial cancellation request has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization"]}},"schemaId":"components/schemas/payments_partialCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_partialCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_partialCancel_response","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/partialcancel"}],"panels":[]}]},"httpPath":"/payments/authorizations/cancellations/partials/{linkData}"},{"label":"Increase authorization amount","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/increaseauthorize","routeSlug":"/products/card-payments/openapi/manage-payments/increaseauthorize","metadata":{"seo":{"title":"Increase authorization amount","description":"If you want to increase an initial estimated authorization amount (submitted with estimated set to true), you can send a incremental authorization request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"increaseAuthorize","name":"Increase authorization amount","isWebhook":false,"pointer":"/paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Increase authorization amount","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you want to increase an initial estimated authorization amount (submitted with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"estimated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), you can send a incremental authorization request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You must use the latest next action links returned by the incremental authorization response to settle (full/partial) and cancel (full/partial) the increased authorized amount. Using the next action links returned in your estimated authorization response will not use any increased amounts."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_increaseAuthorize","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"schemaId":"components/schemas/payments_increaseAuthorize","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"],"pointer":"/paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/authorizations/incrementalAuthorizations/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_increaseAuthorize","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/authorizations/incrementalAuthorizations/{linkData}","href":"manage-payments/increaseauthorize","openApiOperationId":"increaseAuthorize","summary":"Increase authorization amount"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"schemaId":"components/schemas/payments_increaseAuthorize","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeSchemas":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_increaseAuthorize","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The request to increase the authorization amount has been successfully processed","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_357","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount","paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount"]}},"schemaId":"schema_357","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount","paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount"]},{"code":"400","description":"Bad request","mediaType":"aapplication/vnd.worldpay.payments-v7+json","mediaTypes":["aapplication/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"aapplication/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"schema_357","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount","paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"schema_357","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount","paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["aapplication/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"aapplication/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/increaseauthorize"}],"panels":[]}]},"httpPath":"/payments/authorizations/incrementalAuthorizations/{linkData}"},{"label":"Reversal","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/manage-payments/reversal","routeSlug":"/products/card-payments/openapi/manage-payments/reversal","metadata":{"seo":{"title":"Reversal","description":"Your reversal request is processed as a cancel or refund request. This depends on the time passed after your sale request was submitted. For US entities the payment is refunded after one day after a successful sale request. Any other payment moves to refunded after 15 minutes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"reversal","name":"Reversal","isWebhook":false,"pointer":"/paths/~1payments~1sales~1reversals~1{linkData}/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reversal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your reversal request is processed as a cancel or refund request. This depends on the time passed after your sale request was submitted. For US entities the payment is refunded after one day after a successful sale request. Any other payment moves to refunded after 15 minutes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" No request body is needed for this request."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1sales~1reversals~1{linkData}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1sales~1reversals~1{linkData}/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payments/sales/reversals/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["202","400","401","404","415","500"],"pointer":"/payments/sales/reversals/{linkData}","href":"manage-payments/reversal","openApiOperationId":"reversal","summary":"Reversal"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"The reversal request has been accepted","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_reversal_response","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement"]}},"schemaId":"components/schemas/payments_reversal_response","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1sales~1reversals~1{linkData}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"components/schemas/payments_reversal_response","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_reversal_response","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/manage-payments/reversal"}],"panels":[]}]},"httpPath":"/payments/sales/reversals/{linkData}"}],"content":{"contentType":"group","meta":{"name":"Manage payments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Manage payments","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payments/settlements/full/{linkData}","summary":"Settle for full amount","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/settle","deprecated":false},{"title":"/payments/settlements/partials/{linkData}","summary":"Settle for partial amount","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/partialsettlement","deprecated":false},{"title":"/payments/settlements/refunds/full/{linkData}","summary":"Refund full amount","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/refund","deprecated":false},{"title":"/payments/settlements/refunds/partials/{linkData}","summary":"Refund partial amount","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/partialrefund","deprecated":false},{"title":"/payments/authorizations/cancellations/{linkData}","summary":"Cancel full authorization","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/cancel","deprecated":false},{"title":"/payments/authorizations/cancellations/partials/{linkData}","summary":"Cancel partial authorization","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/partialcancel","deprecated":false},{"title":"/payments/authorizations/incrementalAuthorizations/{linkData}","summary":"Increase authorization amount","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/increaseauthorize","deprecated":false},{"title":"/payments/sales/reversals/{linkData}","summary":"Reversal","prefix":{"name":"post","color":"post"},"badges":[],"link":"/manage-payments/reversal","deprecated":false}]}]}]}]}},{"type":"group","label":"Recover payments","link":"/products/card-payments/openapi/recover-payments","routeSlug":"/products/card-payments/openapi/recover-payments","items":[{"label":"Recover payment status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/recover-payments/eventrecovery","routeSlug":"/products/card-payments/openapi/recover-payments/eventrecovery","metadata":{"seo":{"title":"Recover payment status","description":"Send a request to find out the current status of your payment after it has been authorized using its associated transactionReference and entity."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"eventRecovery","name":"Recover payment status","isWebhook":false,"pointer":"/paths/~1payments~1events/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Recover payment status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send a request to find out the current status of your payment after it has been authorized using its associated transactionReference and entity."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Important:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only use this for recovery purposes for example when your authorization request has timed out or you are unable to locate a payment through our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/payment-queries"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment Queries API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If the query returns results, you can manage the payment using the next action links returned in the response of your GET request."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"transactionRef","in":"query","schemaId":"schema_358","description":"A unique reference generated by you that is used to identify a payment throughout its lifecycle.","required":true,"example":"Memory265-13/08/1876"},{"name":"entity","in":"query","schemaId":"schema_359","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier we provide during onboarding. Some merchants may have more than one "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Direct your payment accordingly to assist with billing, reporting and reconciliation."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1payments~1events/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1events/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payments/events","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[],"query":[{"name":"transactionRef","in":"query","required":true,"example":"Memory265-13/08/1876","schemaId":"components/schemas/transactionReference"},{"name":"entity","in":"query","required":true,"example":"default","schemaId":"components/schemas/entity"}],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","404","415","500"],"pointer":"/payments/events","href":"recover-payments/eventrecovery","openApiOperationId":"eventRecovery","summary":"Recover payment status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Retrieve the last event of a payment","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_events_recovery_200_response","exampleIds":["paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]}},"schemaId":"components/schemas/payments_events_recovery_200_response","exampleIds":["paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1events/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/payments_events_recovery_200_response","exampleIds":["paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_events_recovery_200_response","exampleIds":["paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/recover-payments/eventrecovery"}],"panels":[]}]},"httpPath":"/payments/events"},{"label":"Query payment status","deprecated":true,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/card-payments/openapi/recover-payments/eventquery","routeSlug":"/products/card-payments/openapi/recover-payments/eventquery","metadata":{"seo":{"title":"Query payment status","description":"Send a request to find out the current status of your payment after it has been authorized using the events action link."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"eventQuery","name":"Query payment status","deprecated":true,"isWebhook":false,"pointer":"/paths/~1payments~1events~1{linkData}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Query payment status","badges":[{"name":"Deprecated - Use Payment Queries API","color":"orange"}],"isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send a request to find out the current status of your payment after it has been authorized using the events action link."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" It can take up to 15 minutes for a payment event to update."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"linkData","in":"path","schemaId":"schema_356","description":"Action link that's received in your request.","required":true}],"pointer":"/paths/~1payments~1events~1{linkData}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_353","required":true},{"name":"Accept","in":"header","schemaId":"schema_353","required":true}],"pointer":"/paths/~1payments~1events~1{linkData}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payments/events/{linkData}","servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"parameters":{"path":[{"name":"linkData","in":"path","required":true,"schemaId":"schema_356"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"},{"name":"Accept","in":"header","required":true,"example":"application/vnd.worldpay.payments-v7+json","schemaId":"schema_353"}],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","404","415","500"],"pointer":"/payments/events/{linkData}","href":"recover-payments/eventquery","openApiOperationId":"eventQuery","summary":"Query payment status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Retrieve the last event of a payment","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_events_200_response","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]}},"schemaId":"components/schemas/payments_events_200_response","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]},{"code":"400","description":"Bad request","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}},"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]},{"code":"401","description":"Unauthorized","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]},{"code":"404","description":"Not found","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]},{"code":"415","description":"Unsupported media type","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]},{"code":"500","description":"Internal server error","mediaType":"application/vnd.worldpay.payments-v7+json","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1payments~1events~1{linkData}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/payments_events_200_response","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/payments_events_200_response","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"]}}},{"code":"400","schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ValidationErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"]}}},{"code":"415","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"],"mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"]}}},{"code":"500","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/vnd.worldpay.payments-v7+json"],"mediaTypeContent":{"application/vnd.worldpay.payments-v7+json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/recover-payments/eventquery"}],"panels":[]}]},"badges":[{"name":"Deprecated - Use Payment Queries API","color":"orange"}],"httpPath":"/payments/events/{linkData}"}],"content":{"contentType":"group","meta":{"name":"Recover payments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Recover payments","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payments/events","summary":"Recover payment status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/recover-payments/eventrecovery","deprecated":false},{"title":"/payments/events/{linkData}","summary":"Query payment status","prefix":{"name":"get","color":"http-deprecated"},"badges":[{"name":"Deprecated - Use Payment Queries API","color":"orange"}],"link":"/recover-payments/eventquery","deprecated":true}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/transactionReference":{"id":"components/schemas/transactionReference","kind":"json-schema","title":"transactionReference","data":{"maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"A unique reference generated by you that is used to identify a payment throughout its lifecycle."}},"components/schemas/entity":{"id":"components/schemas/entity","kind":"json-schema","title":"entity","data":{"maxLength":32,"minLength":1,"pattern":"^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$","example":"default","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier we provide during onboarding. Some merchants may have more than one "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Direct your payment accordingly to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries."},"children":[]}]}]}]}},"components/schemas/mcc":{"id":"components/schemas/mcc","kind":"json-schema","title":"mcc","data":{"pattern":"^\\d{4}$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can apply a merchant category code "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mcc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to an individual request. You can only provide an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mcc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if we have enabled the dynamic mcc feature during boarding. If enabled but not provided, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merchant.mcc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" defaults to a configured value."},"children":[]}]}]}],"maxLength":4,"minLength":4}},"components/schemas/paymentFacilitator":{"id":"components/schemas/paymentFacilitator","kind":"json-schema","title":"paymentFacilitator","data":{"required":["schemeId","subMerchant"],"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object containing payment facilitator information. This information is required for every authorization "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only if you are a payment facilitator"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You can't send payment facilitator data together with ramp provider data."},"children":[]}]}]}],"properties":{"schemeId":{"maxLength":11,"minLength":1,"pattern":"[0-9]*$","type":"string","description":"Your payment facilitator ID received from Visa, Mastercard, or Amex."},"independentSalesOrganizationId":{"maxLength":11,"minLength":1,"pattern":"[0-9]*$","type":"string"},"subMerchant":{"required":["reference","name","address"],"type":"object","properties":{"name":{"maxLength":25,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z0-9 ]*$","type":"string"},"reference":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]*$"},"address":{"type":"object","required":["postalCode","street","city","countryCode"],"properties":{"postalCode":{"maxLength":10,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s]*$","type":"string","example":"SW1 1AA"},"street":{"maxLength":50,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z0-9\\s]*$","type":"string","example":"221B Baker Street"},"city":{"maxLength":13,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z\\s-]*$","type":"string","example":"London"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"The state code of the subMerchant in ISO-3166-2 format."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Country code of the subMerchant in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"phoneNumber":{"maxLength":20,"minLength":4,"pattern":"^(?!\\s*$)[0-9\\s()+-/.x]*$","type":"string"},"taxReference":{"maxLength":20,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s-]*$","type":"string"},"email":{"maxLength":40,"minLength":1,"type":"string","pattern":"^.+@.+$"},"url":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9@!£*#$)(+-_=.,/;:]*$","type":"string"}}}}}},"components/schemas/rampProvider":{"id":"components/schemas/rampProvider","kind":"json-schema","title":"rampProvider","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Information about the ramp provider and associated conversion affiliate."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You can't send ramp provider data together with payment facilitator data."},"children":[]}]}]}],"properties":{"reference":{"type":"string","example":"12345677898","minLength":1,"maxLength":11,"pattern":"^[A-Za-z0-9]{1,11}$","description":"Registered ramp provider ID."},"conversionAffiliate":{"type":"object","properties":{"reference":{"type":"string","description":"Registered conversion affiliate's ID.","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]{1,15}$","example":"1234567890"},"name":{"type":"string","minLength":1,"maxLength":22,"pattern":"^[A-Za-z0-9 @!£*#$)(+\\-_=.,/;:'\"]+$","description":"Conversion affiliate's name.","example":"Name"},"address":{"type":"object","required":["countryCode"],"properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code.","example":"US"}}},"url":{"type":"string","format":"uri","description":"Conversion affiliate's URL.","minLength":1,"maxLength":255,"example":"http://some-url-here.com"},"taxReference":{"type":"string","minLength":1,"maxLength":20,"pattern":"^[A-Za-z0-9 @!£*#$)(+\\-_=.,/;:'\"]+$","description":"Conversion affiliate's tax reference.","example":"987-654-4321"}},"required":["reference","name","address"]}},"required":["reference"]}},"components/schemas/taxReference":{"id":"components/schemas/taxReference","kind":"json-schema","title":"taxReference","data":{"maxLength":20,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s-]*$","type":"string","description":"Merchant's tax reference."}},"components/schemas/narrative":{"id":"components/schemas/narrative","kind":"json-schema","title":"narrative","data":{"required":["line1"],"type":"object","description":"The text that appears on your customer's statement. Used to identify the merchant.","properties":{"line1":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[a-zA-Z0-9 _!@#$%()*=.:;?[]{}~/+-,`^&]*$","description":"The first line of the narrative which appears on your customer's statement (24 characters max. If character is not supported it is replaced with a space)."},"line2":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[a-zA-Z0-9 _!@#$%()*=.:;?[]{}~/+-,`^&]*$","description":"Additional details about the payment e.g. order number, telephone number."}}}},"components/schemas/routing":{"id":"components/schemas/routing","kind":"json-schema","title":"routing","data":{"type":"object","description":"An object containing specific routing preferences.","properties":{"fundingType":{"type":"string","description":"Specifies the credit or debit functionality of a combo card.","enum":["credit","debit"]},"preferredCardBrand":{"type":"string","enum":["visa","mastercard","maestro","amex","cartesBancaires","diners","dankort","jcb","discover","elo","eftposAU","unionPay","bc","hana","hyundai","kookmin","lotte","nonghyup","samsung","shinhan"],"description":"Specifies your customer's preferred card brand to be used for the transaction using a co-badged card."}}}},"components/schemas/requestAccountUpdater":{"id":"components/schemas/requestAccountUpdater","kind":"json-schema","title":"requestAccountUpdater","data":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allows you to request a real-time account update when using a previously stored card. You can only use this with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customerAgreement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" transactions with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If the stored card details that you provided for the transaction are no longer valid and new credentials are available, the authorization will be processed with the new card and its details will be returned in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"updatedPaymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object in the response."},"children":[]}]}]}]}},"components/schemas/debtRepayment":{"id":"components/schemas/debtRepayment","kind":"json-schema","title":"debtRepayment","data":{"type":"boolean","description":"Debt Repayment Indicator is a flag which identifies a payment with the purpose of repaying a debt."}},"components/schemas/consumerBillPayment":{"id":"components/schemas/consumerBillPayment","kind":"json-schema","title":"consumerBillPayment","data":{"type":"boolean","description":"Consumer Bill Payment is a flag which identifies a bill payment paid by providers on behalf of consumers."}},"components/schemas/recipient":{"id":"components/schemas/recipient","kind":"json-schema","title":"recipient","data":{"type":"object","description":"Additional transaction recipient data.","properties":{"accountReference":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"Partial account reference of the primary recipient. Either partial card number (first 6 and last 4, no spaces), or a bank account number","example":"4444331111"},"lastName":{"maxLength":60,"minLength":1,"pattern":"^[a-zA-Z@!£*#$)(+-_=.,/;:'\" ]*$","type":"string","description":"The last name of the recipient. If for a business, then use the company name.","example":"Smith"},"address":{"type":"object","description":"Address of the recipient.","required":["postalCode"],"properties":{"postalCode":{"maxLength":7,"minLength":5,"pattern":"^[A-Z0-9 ]*$","type":"string","description":"The postal code of the recipient (UK only)"}}},"dateOfBirth":{"type":"object","description":"Birth date of the recipient.","required":["day","month","year"],"properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}}}}}},"components/schemas/industryData":{"id":"components/schemas/industryData","kind":"json-schema","title":"industryData","data":{"type":"object","description":"An object containing industry-specific order data.","oneOf":[{"$ref":"#/components/schemas/industryData_airline"},{"$ref":"#/components/schemas/industryData_lodging"}],"discriminator":{"mapping":{"airline":"#/components/schemas/industryData_airline","lodging":"#/components/schemas/industryData_lodging"},"propertyName":"type"},"required":["type"]}},"components/schemas/industryData_lodging":{"id":"components/schemas/industryData_lodging","kind":"json-schema","title":"industryData_lodging","data":{"type":"object","required":["type","folioNumber","checkInDate","checkOutDate","numberOfNights","roomRate"],"properties":{"type":{"type":"string","enum":["lodging"]},"folioNumber":{"type":"string","description":"Customer folio number, invoice number or billing ID number.","minLength":1,"maxLength":25,"pattern":"^[A-Za-z0-9 @!£*#$()+=._,\\/;:'\"-]{1,25}$","example":"INV-12345-A"},"checkInDate":{"type":"object","description":"An object containing the check in date.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"checkOutDate":{"type":"object","description":"An object containing the check out date.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"numberOfNights":{"type":"integer","description":"Total number of nights the room is booked for.","minimum":0,"maximum":99,"example":3},"roomRate":{"type":"integer","description":"The rate for the room in minor currency units (e.g., pence for GBP).","minimum":0,"example":6000},"roomTax":{"type":"integer","description":"Total room tax in minor currency units (e.g., pence for GBP).","minimum":0,"example":900},"adultGuests":{"type":"integer","description":"Total number of adult guests.","minimum":0,"maximum":99,"example":2},"programCode":{"type":"string","description":"Charge type for the billing purpose.","enum":["lodging","noShow","advancedDeposit"]},"customerServicePhone":{"type":"string","description":"The toll-free phone number for the facility.","minLength":1,"maxLength":17,"pattern":"^[0-9 ()+\\-\\/.x]{1,17}$","example":"08001233644669"},"propertyLocalPhone":{"type":"string","description":"The lodging property's phone number.","minLength":1,"maxLength":17,"pattern":"^[0-9 ()+\\-\\/.x]{1,17}$","example":"08001233644669"},"fireSafetyIndicator":{"type":"boolean","description":"Identifies that the facility complies with the Hotel and Motel Fire Safety Act of 1990.","example":true},"renterName":{"type":"string","description":"Name of the person or business entity charged for the reservation.","minLength":1,"maxLength":26,"pattern":"^[A-Za-z0-9 @!£*#$()+=._,\\/;:'\"-]{1,26}$","example":"John Smith"},"additionalCharges":{"type":"array","description":"Array for the additional charges associated with the booking.","maxItems":6,"items":{"type":"object","properties":{"type":{"type":"string","description":"Type of lodging charge","enum":["barberBeautySalon","businessCentre","cancellationAdjustment","chargesAfterCheckout","convenience","convention","discount","folioCashAdvances","foodBeverages","giftShop","goodsServices","healthClub","insurancePurchased","internetService","laundry","meetingConference","miniBar","movie","noShow","occupancyTax","other","parking","pet","prepaidExpenses","proShop","restaurant","rewardProgramTransaction","surcharge","telephone","tipGratuity","tours","valetParking"]},"amount":{"type":"integer","description":"Amount for the charge type in minor currency units (e.g., pence for GBP).","minimum":0,"example":4500}},"required":["type","amount"]}}}}},"components/schemas/industryData_airline":{"id":"components/schemas/industryData_airline","kind":"json-schema","title":"industryData_airline","data":{"type":"object","properties":{"type":{"enum":["airline"],"type":"string"},"airlineName":{"type":"string","description":"The name of the airline (displayed as it would be on a bill).","example":"Cobb Air","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9 @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"ticket":{"type":"object","description":"An object containing ticket details.","properties":{"number":{"type":"string","description":"The ticket number.","example":"123","minLength":1,"maxLength":16,"pattern":"^[A-Za-z0-9]+$"},"issuerAddress":{"type":"object","description":"An object containing the ticket issuer's address.","properties":{"address1":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9 ]+$"},"city":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9 ]+$"},"countryCode":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"postalCode":{"type":"string","minLength":1,"maxLength":10,"pattern":"^[A-Za-z0-9 ]+$"}},"required":["address1","city","countryCode","postalCode"]},"flightDetails":{"description":"An array with objects containing flight details. Each object represents one leg of a flight and you can submit up to four flight legs within this array.","items":{"type":"object","properties":{"fareClassCode":{"type":"string","description":"The code used by airlines to identify a fare type.","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"departureAirport":{"type":"string","description":"The three letter IATA Airport Code for the departure airport.","example":"LHR","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"},"arrivalAirport":{"type":"string","description":"The three letter IATA Airport Code for the destination airport.","example":"SYD","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"},"carrierCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Same as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"industryData.airlineCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the code represents the airline for the specific flight leg."},"children":[]}]}]}],"example":"M1","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"fareBasisCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional extension to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fareClassCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for custom codes."},"children":[]}]}]}],"example":"TMYA","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"flightCode":{"type":"string","description":"The flight code.","example":"501","minLength":1,"maxLength":5,"pattern":"^[0-9]+$"},"departureDate":{"type":"object","description":"An object containing the date of the departure.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"stopOver":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if this flight leg is a stopover, connecting different destinations."},"children":[]}]}]}]},"taxAmount":{"type":"integer","description":"The tax amount for this specific flight leg.","example":3500}},"required":["carrierCode","flightCode","departureAirport","arrivalAirport","departureDate","fareClassCode","taxAmount"]},"type":"array"},"restricted":{"type":"boolean","description":"Typically, restricted airfares require approval and e-ticket processing within 24 hours of making the reservation, are not transferable if cancelled, and can have specific requirements on when or whether a cancelled ticket can be rebooked. You must define if the ticket is restricted, but this does not affect the payment flows."},"issueDate":{"type":"object","description":"An object containing the ticket's issue date.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]}},"required":["number","restricted","issuerAddress"]},"agentName":{"type":"string","description":"The name of the travel agent.","example":"J Small and Co","minLength":1,"maxLength":26,"pattern":"^[A-Za-z0-9 @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"agentCode":{"type":"string","description":"The IATA travel agency code.","example":"12345678","minLength":1,"maxLength":8,"pattern":"^[0-9]+$"},"invoiceReference":{"type":"string","description":"Billing Settlement Plan invoice reference.","minLength":1,"maxLength":14,"pattern":"^[A-Za-z0-9]+$"},"airlineCode":{"type":"string","description":"The two character IATA airline code.","example":"CA","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"passenger":{"type":"object","description":"An object containing passenger details.","properties":{"code":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"firstName":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"lastName":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"}},"required":["code","firstName","lastName"]}},"required":["type","ticket","airlineName","airlineCode","agentCode","passenger"]}},"components/schemas/shipping":{"id":"components/schemas/shipping","kind":"json-schema","title":"shipping","data":{"type":"object","description":"An object containing shipping details.","properties":{"sender":{"type":"object","properties":{"address":{"type":"object","description":"An object containing sender's (shipped from) address.","properties":{"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"}}}}},"recipient":{"type":"object","properties":{"address":{"type":"object","description":"An object containing recipient's shipping address.","properties":{"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"}}}}}}}},"components/schemas/order":{"id":"components/schemas/order","kind":"json-schema","title":"order","data":{"type":"object","description":"An object containing details about the order.","properties":{"taxExempt":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A flag to indicate whether the purchase is exempt from tax. Must be set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order.salesTax"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 0."},"children":[]}]}]}]},"orderDate":{"type":"object","description":"Date of the order.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"items":{"description":"Array of order items. You can send up to 99 individual order objects within this array.","items":{"type":"object","required":["name"],"properties":{"commodityCode":{"maxLength":12,"minLength":1,"type":"string","description":"Commodity code as defined by the National Institute of Governmental Purchasing.","pattern":"^[A-Za-z0-9@!£*#$)(-+_=.,/;:'\"]{1,12}$","example":"ABC123@#"},"totalTaxAmount":{"type":"integer","description":"Total tax amount for the item(s)."},"unitCost":{"type":"integer","description":"The price of one unit of the item purchased."},"totalAmount":{"type":"integer","description":"Total cost of the item(s) including tax."},"totalAmountNoTax":{"type":"integer","description":"Total cost of the item(s) excluding tax."},"unitOfMeasure":{"maxLength":8,"minLength":1,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unit of measure of the purchased item. Explains how to interpret "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"items.quantity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, e.g. quantity = 15, unitOfMeasure = kg."},"children":[]}]}]}],"pattern":"^[A-Za-z0-9@!£*#$)(+_=.,/;:'\"-]{1,8}$"},"name":{"maxLength":26,"minLength":1,"type":"string","description":"Name of the item(s).","pattern":"^[A-Za-z0-9 @!£*#$)(+_=.,/;:'\"-]{1,26}$"},"quantity":{"type":"integer","description":"Number of items purchased."},"productCode":{"maxLength":12,"minLength":1,"type":"string","description":"Merchant defined product code.","pattern":"^[A-Za-z0-9@!£*#\\$)(+_=.,/;:'\"-]{1,12}$"},"totalDiscountAmount":{"type":"integer","description":"Total discount amount for the item(s)."}}},"type":"array"},"dutyAmount":{"type":"integer","description":"Total amount of duty costs for the order."},"salesTax":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total amount of sales tax for the order. Must be provided if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merchant.taxReference"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied."},"children":[]}]}]}]},"shippingAmount":{"type":"integer","description":"Total amount of shipping costs for the order."},"invoiceReference":{"maxLength":15,"minLength":1,"type":"string","description":"Invoice reference for the order.","pattern":"^[A-Za-z0-9 @!£*#\\$)\\(+_=.,/;:'\"-]{1,15}$"},"discountAmount":{"type":"integer","description":"Total amount of discounts for the order."}}}},"components/schemas/orderReference":{"id":"components/schemas/orderReference","kind":"json-schema","title":"orderReference","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A reference, generated by you, that you can apply to one or more payments according to your business needs. You may reuse the same reference across multiple payments, for example where:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the total amount for a single order is split across multiple payments"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you use a single reference for each payment in a recurring agreement or split shipment scenario"},"children":[]}]}]}]}],"maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~/+]*$","example":"order-12345"}},"components/schemas/value":{"id":"components/schemas/value","kind":"json-schema","title":"value","data":{"required":["amount","currency"],"type":"object","description":"An object that contains information about the value of the payment.","properties":{"amount":{"type":"integer","description":"The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50.","example":250},"currency":{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The three character currency code. See list of "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supported currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"}}}},"components/schemas/expiryDateCard":{"id":"components/schemas/expiryDateCard","kind":"json-schema","title":"expiryDateCard","data":{"required":["month","year"],"type":"object","description":"Contains your customer's card expiry date.","properties":{"month":{"type":"integer","pattern":"^([1-9]|1[0-2])$","example":7},"year":{"type":"integer","pattern":"^([1-9]{1}[0-9]{3})$","example":2050}}}},"components/schemas/expiryDateToken":{"id":"components/schemas/expiryDateToken","kind":"json-schema","title":"expiryDateToken","data":{"required":["month","year"],"type":"object","description":"Contains your customer's token expiry date.","properties":{"month":{"type":"integer","pattern":"^([1-9]|1[0-2])$","example":7},"year":{"type":"integer","pattern":"^([1-9]{1}[0-9]{3})$","example":2050}}}},"components/schemas/cardHolderName":{"id":"components/schemas/cardHolderName","kind":"json-schema","title":"cardHolderName","data":{"type":"string","minLength":1,"maxLength":255,"description":"The cardholder's name as it appears on their card."}},"components/schemas/cvc":{"id":"components/schemas/cvc","kind":"json-schema","title":"cvc","data":{"type":"string","maxLength":4,"minLength":3,"pattern":"^[0-9]+$","description":"CVC is a unique set of 3 or 4 numbers used to verify the card. Our API checks to see if the CVC supplied matches the CVC held by the issuing bank."}},"components/schemas/cardNumber":{"id":"components/schemas/cardNumber","kind":"json-schema","title":"cardNumber","data":{"type":"string","maxLength":19,"minLength":12,"pattern":"^[0-9]+$","description":"Your customer's card number. Sometimes referred to as Primary Account Number (PAN)."}},"components/schemas/tokenNumber":{"id":"components/schemas/tokenNumber","kind":"json-schema","title":"tokenNumber","data":{"type":"string","maxLength":19,"minLength":12,"pattern":"^[0-9]+$","description":"The network token number."}},"components/schemas/billingAddress":{"id":"components/schemas/billingAddress","kind":"json-schema","title":"billingAddress","data":{"required":["postalCode","countryCode"],"type":"object","description":"Contains the billing address information.","properties":{"address1":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First line of the address. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"City. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"postalCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Post code. Required, but an empty value can be provided for specific countries (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"state":{"type":"string","description":"State/province in max 3 characters."},"countryCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be provided in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"phoneNumber":{"type":"string","description":"Phone number.","minLength":3,"maxLength":20,"pattern":"^[0-9()+-/.x ]+$"}}}},"components/schemas/customerInitiatedTransaction":{"id":"components/schemas/customerInitiatedTransaction","kind":"json-schema","title":"customerInitiatedTransaction","data":{"required":["transactionReference","merchant","instruction","channel"],"type":"object","properties":{"transactionReference":{"$ref":"#/components/schemas/transactionReference"},"orderReference":{"$ref":"#/components/schemas/orderReference"},"channel":{"enum":["ecom","moto"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Interaction between the cardholder and you. Supply a value of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ecom"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to process an eCommerce authorization. Supply a value of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"moto"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to process an authorization as a Mail Order or Telephone Order transaction. Note: 3DS "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authentication"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be supplied for MOTO payments."},"children":[]}]}]}]},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant.","properties":{"entity":{"$ref":"#/components/schemas/entity"},"mcc":{"$ref":"#/components/schemas/mcc"},"paymentFacilitator":{"$ref":"#/components/schemas/paymentFacilitator"},"rampProvider":{"$ref":"#/components/schemas/rampProvider"},"taxReference":{"$ref":"#/components/schemas/taxReference"}}},"instruction":{"required":["value","narrative","paymentInstrument","requestAutoSettlement"],"type":"object","description":"An object that contains all information related to the payment.","properties":{"requestAutoSettlement":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the transaction should be sent for settlement now "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or later "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", at a time of your choosing."},"children":[]}]}]}],"properties":{"enabled":{"type":"boolean"}}},"value":{"allOf":[{"$ref":"#/components/schemas/value"},{"type":"object","properties":{"estimated":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for an estimated authorization value, which you can "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/card-payments/manage-payments#increase-an-authorization"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"increase at a later stage"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for estimated authorizations."},"children":[]}]}]}]},"acceptPartialAmount":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to accept partial authorization amount. You can charge the remainder of the amount using a different payment credential with a new authorization request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for partial authorizations."},"children":[]}]}]}]},"surchargeAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing processing and service fees. Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The surcharge fee is included in the total transaction amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100, then the actual cost of goods/services is $80."},"children":[]}]}]}]},"convenienceAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing the offer of a convenient payment method or channel (such as online booking fee). Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"convenienceAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The convenience fee is included in the total transaction amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.convenienceAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100, then the actual cost of goods/services is $80."},"children":[]}]}]}]}}}]},"narrative":{"$ref":"#/components/schemas/narrative"},"paymentInstrument":{"type":"object","oneOf":[{"$ref":"#/components/schemas/card_plain"},{"$ref":"#/components/schemas/card_token"},{"$ref":"#/components/schemas/card_networkToken"},{"$ref":"#/components/schemas/card_checkout"},{"$ref":"#/components/schemas/card_wallet_applepay"},{"$ref":"#/components/schemas/card_wallet_googlepay"},{"$ref":"#/components/schemas/card_networkToken_applepay"},{"$ref":"#/components/schemas/card_networkToken_googlepay"}],"discriminator":{"mapping":{"card/plain":"#/components/schemas/card_plain","card/token":"#/components/schemas/card_token","card/networkToken":"#/components/schemas/card_networkToken","card/checkout":"#/components/schemas/card_checkout","card/wallet+applepay":"#/components/schemas/card_wallet_applepay","card/wallet+googlepay":"#/components/schemas/card_wallet_googlepay","card/networkToken+applepay":"#/components/schemas/card_networkToken_applepay","card/networkToken+googlepay":"#/components/schemas/card_networkToken_googlepay"},"propertyName":"type"}},"customerAgreement":{"type":"object","description":"Contains specific customer agreements for the transaction.","oneOf":[{"$ref":"#/components/schemas/cit_cardOnFile"},{"$ref":"#/components/schemas/cit_subscription"},{"$ref":"#/components/schemas/cit_installment"}],"discriminator":{"propertyName":"type","mapping":{"cardOnFile":"#/components/schemas/cit_cardOnFile","subscription":"#/components/schemas/cit_subscription","installment":"#/components/schemas/cit_installment"}}},"consumerBillPayment":{"$ref":"#/components/schemas/consumerBillPayment"},"debtRepayment":{"$ref":"#/components/schemas/debtRepayment"},"requestAccountUpdater":{"$ref":"#/components/schemas/requestAccountUpdater"},"fundsTransfer":{"$ref":"#/components/schemas/fundsTransfer"},"routing":{"$ref":"#/components/schemas/routing"}}},"riskProfile":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used to apply the SCA exemption in the payment request and update the FraudSight data model to benefit future payments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If using either the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/fraudsight/assessment#linking-the-fraudsight-assessment"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"FraudSight"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/sca-exemptions/assessment#applying-the-exemption"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exemptions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" API you "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" provide this."},"children":[]}]}]}],"example":"https://try.access.worldpay.com/riskProfile/{linkData}"},"authentication":{"description":"An object containing authentication details.","properties":{"threeDS":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"3DS authentication data. Only allowed for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/checkout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/networkToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" payment instruments."},"children":[]}]}]}],"required":["version","eci"],"properties":{"version":{"maxLength":10,"minLength":5,"type":"string","description":"The version of 3DS used to process the transaction.","example":"2.2.0"},"eci":{"maxLength":2,"minLength":2,"type":"string","description":"Electronic Commerce Indicator (ECI).","example":"05","pattern":"^[0-9]{2}$"},"authenticationValue":{"maxLength":40,"minLength":1,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required, if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authentication.eci"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value is 01, 02, 05 or 06.  A cryptographic value that provides evidence of the outcome of a 3DS verification."},"children":[]}]}]}],"example":"kBNHXUAy4+HT1gAMBSDajheBcxQh"},"transactionId":{"maxLength":36,"minLength":36,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required, if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authentication.eci"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value is 01, 02, 05 or 06.  A unique authentication transaction identifier, generated by the issuer."},"children":[]}]}]}],"example":"b8fb4ecc-7e2e-4b1c-816d-0149849776b8","format":"RFC 4122 UUID"},"cryptogramAlgorithm":{"type":"integer","description":"Indicates the algorithm used to generate the cryptogram. For Cartes Bancaires authorizations only.","example":2},"challengePreference":{"type":"string","description":"Indicates the preferred challenge behavior. For Cartes Bancaires authorizations only. Must contain one of the following values.","enum":["noPreference","noChallengeRequested","challengeRequested","challengeMandated","noChallengeRequestedTRAPerformed"]},"authenticationFlow":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"challenge"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if your customer was redirected to their bank to complete authentication, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"frictionless"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if your customer completed authentication without needing to be redirected to their bank. For Cartes Bancaires authorizations only. Must contain one of the following values."},"children":[]}]}]}],"enum":["challenge","frictionless","frictionlessDelegated"]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates the outcome of the authentication or verification request."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Y"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Successful authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"N"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Failed authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"U"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Unable to complete authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Successful attempts authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"I"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Exemption acknowledged"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For Cartes Bancaires authorizations only."},"children":[]}]}]}]},"statusReason":{"type":"string","description":"Provides further information relating to the outcome of the authentication. Returned for failed authentications only. For Cartes Bancaires authorizations only."},"cancellationIndicator":{"type":"string","description":"An indicator as to why the authentication was cancelled. For Cartes Bancaires authorizations only.","minLength":2,"maxLength":2,"pattern":"^[0-9]{2}$","example":"01"},"networkScore":{"type":"string","description":"The global score calculated by the Cartes Bancaires scoring platform. For Cartes Bancaires authorizations only.","minLength":1,"maxLength":2,"pattern":"^[0-9]{1,2}$","example":"7"},"brand":{"type":"string","description":"The card brand used in the authentication. For Cartes Bancaires authorizations only.","enum":["cartesBancaires"]},"exemptionCode":{"type":"string","minLength":4,"maxLength":4,"description":"A code indicating the authentication exemption reason.\n\nFor Cartes Bancaires authorizations only.","enum":["gAAA","QAAA","IAAA","EAAA","CAAA","BAAA","AgAA","AQAA","AAgA","AAQA","AAIA","AAEA"],"x-enumDescriptions":{"gAAA":"Issuer transaction risk analysis","QAAA":"Recurring operations with identical amounts and a specified duration","IAAA":"Delegated authentication","EAAA":"Authentication implementation is not technically possible","CAAA":"Low amount","BAAA":"Acceptor/acquirer transaction risk analysis","AgAA":"Trusted beneficiary","AQAA":"Secure corporate payment process and protocol","AAgA":"Unattended terminal for transport fares and parking fees","AAQA":"Out of RTS SCA scope","AAIA":"Other cases","AAEA":"Transaction risk analysis - merchant in CB Low Risk Merchant program"},"example":"gAAA"}}},"networkToken":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Network Token authentication. Only allowed for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/networkToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" transactions."},"children":[]}]}]}],"required":["cryptogram"],"properties":{"cryptogram":{"type":"string","minLength":1,"maxLength":40,"example":"BLIYQ4EA/wLF4/hK9ABFMAABAAA=","description":"A payment specific value generated during authentication."},"eci":{"maxLength":2,"minLength":2,"type":"string","description":"Electronic Commerce Indicator (ECI).","example":"05","pattern":"^[0-9]{2}$"}}},"customerData":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional customer details necessary to meet local authentication, as required by country-specific regulations. Currently, this object is used solely for domestic transactions in South Korea and applicable to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/checkout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instruments only."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/southKorea_personalAuth"},{"$ref":"#/components/schemas/southKorea_corporateAuth"}],"discriminator":{"mapping":{"southKorea/personal":"#/components/schemas/southKorea_personalAuth","southKorea/corporate":"#/components/schemas/southKorea_corporateAuth"},"propertyName":"type"}}}},"exemption":{"$ref":"#/components/schemas/exemption"},"shipping":{"$ref":"#/components/schemas/shipping"},"order":{"$ref":"#/components/schemas/order"},"recipient":{"$ref":"#/components/schemas/recipient"},"customer":{"type":"object","description":"Additional customer data.","properties":{"documentReference":{"type":"string","description":"Required for domestic processing in some Latin American countries.","minLength":1,"maxLength":50,"pattern":"^[A-Za-z0-9_\\-\\/\\\\*~+.,&()]{1,50}$"},"reference":{"type":"string","description":"Merchant-generated customer reference.","minLength":1,"maxLength":17,"pattern":"^[A-Za-z0-9 @!£*#$()\\+\\-_=.,/;:'\"]{1,17}$"},"ipAddress":{"type":"string","description":"Customer's IP address. Required for certain jurisdictions and/or MCCs.","minLength":1,"maxLength":50,"pattern":"^[a-zA-Z0-9\\-:.]+$"},"emailAddress":{"type":"string","description":"Customer's email address. If enabled, your customer will receive the transaction outcome to this email address.","minLength":1,"maxLength":128,"pattern":"^(?=(?:[^@]*@){1}[^@]*$)[\\x20-\\x7E]{1,128}$"}}},"industryData":{"$ref":"#/components/schemas/industryData"}}}},"components/schemas/merchantInitiatedTransaction":{"id":"components/schemas/merchantInitiatedTransaction","kind":"json-schema","title":"merchantInitiatedTransaction","data":{"required":["transactionReference","merchant","instruction"],"type":"object","properties":{"transactionReference":{"$ref":"#/components/schemas/transactionReference"},"orderReference":{"$ref":"#/components/schemas/orderReference"},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant.","properties":{"entity":{"$ref":"#/components/schemas/entity"},"mcc":{"$ref":"#/components/schemas/mcc"},"paymentFacilitator":{"$ref":"#/components/schemas/paymentFacilitator"},"rampProvider":{"$ref":"#/components/schemas/rampProvider"},"taxReference":{"$ref":"#/components/schemas/taxReference"}}},"instruction":{"required":["value","narrative","paymentInstrument","requestAutoSettlement","customerAgreement"],"type":"object","description":"An object that contains all information related to the payment.","properties":{"requestAutoSettlement":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the transaction should be sent for settlement now "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or later "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", at a time of your choosing."},"children":[]}]}]}],"properties":{"enabled":{"type":"boolean"}}},"value":{"allOf":[{"$ref":"#/components/schemas/value"},{"type":"object","properties":{"acceptPartialAmount":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to accept partial authorization amount. The remainder of the amount can be charged using a different payment credential via a new authorization request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for partial authorizations."},"children":[]}]}]}]},"surchargeAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing processing and service fees. Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is included in the total transaction amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100, then the actual cost of goods/services is $80."},"children":[]}]}]}]},"convenienceAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing the offer of a convenient payment method or channel (such as online booking fee). Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"convenienceAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The convenience fee is included in the total transaction amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.convenienceAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100, then the actual cost of goods/services is $80."},"children":[]}]}]}]}}}]},"narrative":{"$ref":"#/components/schemas/narrative"},"paymentInstrument":{"type":"object","oneOf":[{"$ref":"#/components/schemas/card_plain_mit"},{"$ref":"#/components/schemas/card_token_mit"},{"$ref":"#/components/schemas/card_networkToken"},{"$ref":"#/components/schemas/card_networkToken_applepay"},{"$ref":"#/components/schemas/card_networkToken_googlepay"}],"discriminator":{"mapping":{"card/plain":"#/components/schemas/card_plain_mit","card/token":"#/components/schemas/card_token_mit","card/networkToken":"#/components/schemas/card_networkToken","card/networkToken+applepay":"#/components/schemas/card_networkToken_applepay","card/networkToken+googlepay":"#/components/schemas/card_networkToken_googlepay"},"propertyName":"type"}},"customerAgreement":{"type":"object","description":"Contains specific customer agreements for the transaction.","oneOf":[{"$ref":"#/components/schemas/mit_subscription"},{"$ref":"#/components/schemas/mit_installment"},{"$ref":"#/components/schemas/mit_unscheduled"},{"$ref":"#/components/schemas/mit_reauthorization"},{"$ref":"#/components/schemas/mit_resubmission"},{"$ref":"#/components/schemas/mit_noShow"},{"$ref":"#/components/schemas/mit_delayedCharge"},{"$ref":"#/components/schemas/mit_partialShipment"}],"discriminator":{"propertyName":"type","mapping":{"subscription":"#/components/schemas/mit_subscription","installment":"#/components/schemas/mit_installment","unscheduled":"#/components/schemas/mit_unscheduled","reauthorization":"#/components/schemas/mit_reauthorization","resubmission":"#/components/schemas/mit_resubmission","noShow":"#/components/schemas/mit_noShow","delayedCharge":"#/components/schemas/mit_delayedCharge","partialShipment":"#/components/schemas/mit_partialShipment"}}},"consumerBillPayment":{"$ref":"#/components/schemas/consumerBillPayment"},"requestAccountUpdater":{"$ref":"#/components/schemas/requestAccountUpdater"},"debtRepayment":{"$ref":"#/components/schemas/debtRepayment"},"fundsTransfer":{"$ref":"#/components/schemas/fundsTransfer"},"routing":{"$ref":"#/components/schemas/routing"}}},"recipient":{"$ref":"#/components/schemas/recipient"},"shipping":{"$ref":"#/components/schemas/shipping"},"order":{"$ref":"#/components/schemas/order"},"customer":{"type":"object","description":"Additional customer data.","properties":{"documentReference":{"type":"string","description":"Required for domestic processing in some Latin American countries.","minLength":1,"maxLength":50},"reference":{"type":"string","description":"Merchant-generated customer reference.","minLength":1,"maxLength":17},"emailAddress":{"type":"string","description":"Customer's email address. If enabled by your configuration, your customer will receive the transaction outcome at this email address.","minLength":1,"maxLength":128}}},"industryData":{"$ref":"#/components/schemas/industryData"},"riskProfile":{"type":"string","description":"Used to update the FraudSight data model to benefit future payments.","example":"https://try.access.worldpay.com/riskProfile/{linkData}"}}}},"components/schemas/card_plain":{"id":"components/schemas/card_plain","kind":"json-schema","title":"card_plain","data":{"required":["type","cardNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/plain"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" being used."},"children":[]}]}]}]},"cardNumber":{"$ref":"#/components/schemas/cardNumber"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"expiryDate":{"$ref":"#/components/schemas/expiryDateCard"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cvc":{"$ref":"#/components/schemas/cvc"}}}},"components/schemas/card_token":{"id":"components/schemas/card_token","kind":"json-schema","title":"card_token","data":{"required":["type","href"],"type":"object","properties":{"type":{"enum":["card/token"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" being used."},"children":[]}]}]}]},"href":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" address that contains your link to an Access Token."},"children":[]}]}]}]},"cvc":{"$ref":"#/components/schemas/cvc"}}}},"components/schemas/card_plain_mit":{"id":"components/schemas/card_plain_mit","kind":"json-schema","title":"card_plain_mit","data":{"required":["type","cardNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/plain"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" being used."},"children":[]}]}]}]},"cardNumber":{"$ref":"#/components/schemas/cardNumber"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"expiryDate":{"$ref":"#/components/schemas/expiryDateCard"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"}}}},"components/schemas/card_token_mit":{"id":"components/schemas/card_token_mit","kind":"json-schema","title":"card_token_mit","data":{"required":["type","href"],"type":"object","properties":{"type":{"enum":["card/token"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" being used."},"children":[]}]}]}]},"href":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" address that contains your link to an Access Token."},"children":[]}]}]}]}}}},"components/schemas/card_networkToken":{"id":"components/schemas/card_networkToken","kind":"json-schema","title":"card_networkToken","data":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken"],"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" being used."},"children":[]}]}]}]},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}}},"components/schemas/card_checkout":{"id":"components/schemas/card_checkout","kind":"json-schema","title":"card_checkout","data":{"required":["type","tokenHref"],"type":"object","properties":{"type":{"enum":["card/checkout"],"type":"string"},"tokenHref":{"type":"string"},"cvcHref":{"type":"string"}}}},"components/schemas/card_wallet_applepay":{"id":"components/schemas/card_wallet_applepay","kind":"json-schema","title":"card_wallet_applepay","data":{"required":["type","walletToken"],"type":"object","properties":{"type":{"enum":["card/wallet+applepay"],"type":"string"},"walletToken":{"type":"string","description":"The encrypted wallet token returned by Apple","example":"{\"version\": \"EC_v1\",\"data\": \"kdHd..GQ==\",\"signature\": \"MIAGCSqGSIb3DQEH...AAA\",\"header\": {\"transactionId\": \"d3b28af..f8\",\"ephemeralPublicKey\": \"MFkwE..Q==\",\"publicKeyHash\": \"dxCK..6o=\"}}"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}}},"components/schemas/card_wallet_googlepay":{"id":"components/schemas/card_wallet_googlepay","kind":"json-schema","title":"card_wallet_googlepay","data":{"required":["type","walletToken"],"type":"object","properties":{"type":{"enum":["card/wallet+googlepay"],"type":"string"},"walletToken":{"type":"string","description":"The encrypted wallet token returned by Google","example":"{\"protocolVersion\":\"ECv1\",\"signature\":\"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\\u003d\\u003d\",\"signedMessage\":\"{\\\"tag\\\":\\\"jpGz1F1Bcoi/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BJatyFvFPPD21l8/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\\\u003d\\\",\\\"encryptedMessage\\\":\\\"mKOoXwi8OavZ\\\"}\"}"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}}},"components/schemas/card_networkToken_applepay":{"id":"components/schemas/card_networkToken_applepay","kind":"json-schema","title":"card_networkToken_applepay","data":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken+applepay"],"type":"string"},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}}},"components/schemas/card_networkToken_googlepay":{"id":"components/schemas/card_networkToken_googlepay","kind":"json-schema","title":"card_networkToken_googlepay","data":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken+googlepay"],"type":"string"},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}}},"components/schemas/fpanLastFour":{"id":"components/schemas/fpanLastFour","kind":"json-schema","title":"fpanLastFour","data":{"type":"string","maxLength":4,"minLength":4,"pattern":"^[0-9]+$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The last four digits of the actual card number, commonly referred to as the Funding Primary Account Number (FPAN). For "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/wallets#card-metadata"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"mobile wallet transactions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the mobile wallet provider (e.g. Apple or Google) returns this to you, where supported by the issuer. For network tokens, retrieve this from your token provider."},"children":[]}]}]}]}},"components/schemas/southKorea_personalAuth":{"id":"components/schemas/southKorea_personalAuth","kind":"json-schema","title":"southKorea_personalAuth","data":{"required":["type","firstTwoOfPin","dateOfBirth"],"type":"object","properties":{"type":{"type":"string","description":"Personal card issued in South Korea.","enum":["southKorea/personal"]},"firstTwoOfPin":{"type":"string","description":"The first two characters of the card's PIN.","minLength":2,"maxLength":2,"example":"34","pattern":"^[0-9]{2}$"},"dateOfBirth":{"type":"object","description":"Cardholder's date of birth.","required":["day","month","year"],"properties":{"day":{"type":"integer","example":1},"month":{"type":"integer","example":1},"year":{"type":"integer","example":1900}}}}}},"components/schemas/southKorea_corporateAuth":{"id":"components/schemas/southKorea_corporateAuth","kind":"json-schema","title":"southKorea_corporateAuth","data":{"required":["firstTwoOfPin","businessRegistrationNumber","type"],"type":"object","properties":{"type":{"type":"string","description":"Corporate card issued in South Korea.","enum":["southKorea/corporate"]},"firstTwoOfPin":{"type":"string","description":"The first two characters of the card's PIN.","minLength":2,"maxLength":2,"example":"34","pattern":"^[0-9]{2}$"},"businessRegistrationNumber":{"type":"string","description":"A unique identifier assigned to businesses when they register with the Korean tax authorities.","minLength":6,"maxLength":10}}}},"components/schemas/updatedPaymentInstrument":{"id":"components/schemas/updatedPaymentInstrument","kind":"json-schema","title":"updatedPaymentInstrument","data":{"type":"object","description":"Details of the updated payment instrument.","properties":{"appliedNetworkToken":{"type":"boolean","description":"Returned if the payment instrument was swapped for a network token."},"accountUpdaterMessage":{"type":"string","description":"Details on the type of payment instrument update.","enum":["The merchant is not registered in the update program","The account number was changed","The account was closed","TThe expiration date was changed","The issuing bank does not participate in the update program","Contact the cardholder for updated information","No match found","No changes found"],"x-enumDescriptions":{"The account number was changed":"A new card has been issued with a change in the card number. Returned for both Real-Time and Managed Account Updater.","The account was closed":"The account is closed and the card is no longer valid. Ask your customer for an alternative payment method. Returned for both Real-Time and Managed Account Updater.","The expiration date was changed":"A new card has been issued with an updated expiry date. In most cases the card number remains unchanged. Returned for both Real-Time and Managed Account Updater.","The issuing bank does not participate in the update program":"It is not known whether an account update is available. Returned for Managed Account Updater only.","Contact the cardholder for updated information":"A match was found but you may need to contact the cardholder for updated card details. This could be due to cardholder opt-out or other reasons. Returned for both Real-Time and Managed Account Updater."},"example":"The account number was changed"},"type":{"type":"string","example":"card/plain+masked"},"cardBin":{"pattern":"^[0-9*]+$","type":"string","description":"The updated card BIN (Bank Identification Number).","example":"444433"},"lastFour":{"pattern":"^[0-9*]+$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The four digits of the updated card. Some characters may be obfuscated with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the PAN length is less than 16 characters."},"children":[]}]}]}],"example":1111},"cardNumber":{"type":"string","description":"The full card number of the updated card. Returned only for merchants configured to receive card numbers that are not obfuscated.","maxLength":19,"minLength":12,"pattern":"^[0-9]+$"},"expiryDate":{"type":"object","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"cardBrand":{"type":"string","description":"The brand of the updated card. In rare circumstances a card may be reissued under a different brand."},"countryCode":{"type":"string","maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Country code of the updated card in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"GB"},"fundingType":{"type":"string","description":"How the card is funded."}}}},"components/schemas/amounts":{"id":"components/schemas/amounts","kind":"json-schema","title":"amounts","data":{"type":"object","description":"An object containing transaction amounts. Returned for partial authorizations.","properties":{"requested":{"type":"integer","description":"The requested amount.","example":1000},"totalAuthorized":{"type":"integer","description":"The total amount authorized by the card issuer.","example":700},"currency":{"maxLength":3,"minLength":3,"type":"string","pattern":"^[A-Z]$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The three character currency code. See list of "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supported currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"GBP"},"partialAuthorization":{"type":"boolean","description":"Indicates that the authorized amount is less than what was requested."}}}},"components/schemas/riskFactors":{"id":"components/schemas/riskFactors","kind":"json-schema","title":"riskFactors","data":{"type":"array","items":{"required":["type","risk"],"type":"object","properties":{"type":{"enum":["avs","cvc","riskProfile"],"type":"string"},"risk":{"enum":["notChecked","notMatched","notSupplied","verificationFailed"],"type":"string","description":"Result of the verification."},"detail":{"enum":["address","postcode"],"type":"string"}}},"description":"Any risk factors which have been identified for the authorization. This section will not appear if no risks are identified."}},"components/schemas/scheme":{"id":"components/schemas/scheme","kind":"json-schema","title":"scheme","data":{"required":["reference"],"type":"object","description":"An object containing information returned by the card scheme.","properties":{"reference":{"type":"string","minLength":1,"maxLength":255,"description":"The reference returned by the scheme for this particular payment authorization. The scheme reference returned in a customer initiated transaction should be provided in all subsequent merchant initiated transactions.","example":"446238472410421"},"supplementaryReference":{"type":"string","minLength":1,"maxLength":255,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"admonition","inline":true,"attributes":{"type":"warning","name":"Coming soon"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Preview only. Not yet available in production."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A secondary reference returned by the scheme for this particular payment authorization. Presently returned only for Mastercard transactions. You must supply any supplementary reference returned in a customer initiated transaction in all subsequent merchant initiated transactions."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please see our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/card-payments/features/mastercard-tlid"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mastercard TLID guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"MCCOLXT1C0104  "}}}},"components/schemas/issuer":{"id":"components/schemas/issuer","kind":"json-schema","title":"issuer","data":{"required":["authorizationCode"],"type":"object","description":"An object containing information returned by the issuer.","properties":{"authorizationCode":{"pattern":"^[a-zA-Z0-9]+$","type":"string","description":"A code returned by the card issuer for a successful authorization. Used in reconciliation and dispute management.","example":"T31306"}}}},"components/schemas/responsePaymentInstrument":{"id":"components/schemas/responsePaymentInstrument","kind":"json-schema","title":"responsePaymentInstrument","data":{"type":"object","description":"Details of the paymentInstrument used.","properties":{"type":{"type":"string"},"cardBin":{"pattern":"^[0-9*]+$","type":"string","description":"The card BIN (Bank Identification Number) is the first 6 or 8 digits of the card number, and can be used to identify the card issuer, the card brand(s) (eg Visa, Cartes Bancaires), and the country. Card BINs are used to route transactions, check card capabilities, and in fraud assessments.","example":"444433"},"lastFour":{"pattern":"^[0-9*]+$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The last four digits of the card. Some characters may be obfuscated with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the PAN length is less than 16 characters."},"children":[]}]}]}],"example":"1111"},"category":{"type":"string","description":"Whether the card is classed as a consumer card or a card for commercial use.","enum":["commercial","consumer"]},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]+$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" country code that the card was issued in. May return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"N/A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" where the country is unknown."},"children":[]}]}]}],"example":"GB"},"issuerName":{"type":"string","description":"The name of the card issuer.","example":"AN ISSUING BANK LTD"},"fundingType":{"type":"string","description":"How the card is funded.","enum":["credit","debit","prepaid","chargeCard","deferredDebit","unknown"]},"cardBrand":{"type":"string","description":"The card brand that the transaction was processed with. Sometimes referred to as the network or scheme.","enum":["visa","mastercard","amex","maestro","visaElectron","diners","discover","jcb","argencard","cabal","carteBleue","cartesBancaires","carnet","cencosud","coopeplus","credimas","dankort","elo","eftposAU","hipercard","italcred","naranja","nativa","nevada","nexo","tarjeta","unionPay","bc","hana","hyundai","kookmin","lotte","nonghyup","samsung","shinhan"]},"paymentAccountReference":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment account reference (PAR) is a non-financial reference that uniquely identifies the underlying cardholder account. This allows you to correlate payments made from the same account with differing instruments (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/wallet+applepay"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), where the same account funds the transaction. A PAR cannot be used to initiate a payment."},"children":[]}]}]}],"example":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"expiryDate":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The expiry date of the card or network token (where the supplied paymentInstrument was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/wallet+applepay"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/wallet+googlepay"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/networkToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/networkToken+applepay"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card/networkToken+googlepay"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}],"properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"debitNetwork":{"type":"string","description":"The debit network that the transaction was routed through. Returned optionally for subscribing merchants.","enum":["accel","affn","alaskaOption","ath","culiancePrime","culiance","interlink","jeanie","maestro","nyce","pavd","pulse","shazam","star","starAccess"]}}}},"components/schemas/advice":{"id":"components/schemas/advice","kind":"json-schema","title":"advice","data":{"type":"object","description":"Advice on the outcome of this request.","properties":{"code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An advice code returned by the card scheme (currently supported: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mastercard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"maestro"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}]}},"required":["code"]}},"components/schemas/exemptionOutcome":{"id":"components/schemas/exemptionOutcome","kind":"json-schema","title":"exemptionOutcome","data":{"required":["result","reason"],"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An exemption result and reason if either a risk profile was included in your authorization request, or if you included the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"exemption"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object in the request."},"children":[]}]}]}],"properties":{"result":{"enum":["honored","outOfScope","rejected"],"type":"string","description":"The result of the requested exemption."},"reason":{"enum":["highRisk","invalid","issuerHonored","issuerRejected","notSubscribed","oneLegOut","unsupportedAcquirer"],"x-enumDescriptions":{"highRisk":"The transaction is deemed high risk by our TRA (Transaction Risk Assessment), and therefore the acquirer exemption cannot be applied.","invalid":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The exemption is invalid. For example, a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lowValue"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" exemption was requested for a requested authorization value greater than 30 EUR."},"children":[]}]}]}],"issuerHonored":"The issuer has accepted the exemption.","issuerRejected":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The issuer has rejected the exemption. You may retry the authorization in certain circumstances (for example if you receive "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refusalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 65, you can retry the transaction with valid 3DS "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authentication"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" data)."},"children":[]}]}]}],"notSubscribed":"You are not subscribed to the exemption service. Please contact your Worldpay Implementation Manager.","oneLegOut":"Either the issuer or the acquirer are located in a region where Strong Customer Authentication is not required. An exemption is not required.","unsupportedAcquirer":"Exemption processing is not currently supported through the selected acquirer."},"type":"string","description":"The reason for the exemption outcome.\n"}}}},"components/schemas/commandId":{"id":"components/schemas/commandId","kind":"json-schema","title":"commandId","data":{"maxLength":36,"minLength":21,"pattern":"^[A-Za-z0-9_-]+$","type":"string","description":"Unique identifier generated by us for a single instance of an interaction (command) with the Worldpay API.","example":"cmdRvD-OxCyXgJLQ9_jbqXAC0"}},"components/schemas/paymentId":{"id":"components/schemas/paymentId","kind":"json-schema","title":"paymentId","data":{"maxLength":36,"minLength":21,"pattern":"^[A-Za-z0-9_-]+$","type":"string","description":"Unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions.","example":"payI-dUcet9fk4_X4qZU0hpU0"}},"components/schemas/payments_links_list_authorized":{"id":"components/schemas/payments_links_list_authorized","kind":"json-schema","title":"payments_links_list_authorized","data":{"type":"object","properties":{"cardPayments:cancel":{"type":"object","description":"An action link to cancel the full authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel the full authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/{linkData}"}}},"cardPayments:partialCancel":{"type":"object","description":"An action link to cancel a portion of the authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel a portion of the authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/{linkData}"}}},"cardPayments:settle":{"type":"object","description":"An action link to send the full authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send the full authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/full/{linkData}"}}},"cardPayments:partialSettle":{"type":"object","description":"An action link to send a portion of the authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send a portion of the authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/partials/{linkData}"}}},"cardPayments:reverse":{"type":"object","description":"An action link to cancel or refund the full amount.","properties":{"href":{"type":"string","description":"An action link to cancel or refund the full amount.","example":"https://try.access.worldpay.com/payments/authorizations/reversals/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_increaseAuthorizedAmount":{"id":"components/schemas/payments_links_list_increaseAuthorizedAmount","kind":"json-schema","title":"payments_links_list_increaseAuthorizedAmount","data":{"type":"object","properties":{"cardPayments:increaseAuthorizedAmount":{"type":"object","description":"An action link to increase the authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel the full authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/incrementalAuthorizations/{linkData}"}}},"cardPayments:cancel":{"type":"object","description":"An action link to cancel the full authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel the full authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/{linkData}"}}},"cardPayments:partialCancel":{"type":"object","description":"An action link to cancel a portion of the authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel a portion of the authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/{linkData}"}}},"cardPayments:settle":{"type":"object","description":"An action link to send the full authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send the full authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/full/{linkData}"}}},"cardPayments:partialSettle":{"type":"object","description":"An action link to send a portion of the authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send a portion of the authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/partials/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_sentForSettlement":{"id":"components/schemas/payments_links_list_sentForSettlement","kind":"json-schema","title":"payments_links_list_sentForSettlement","data":{"type":"object","properties":{"cardPayments:refund":{"type":"object","description":"An action link to refund the full settled amount.","properties":{"href":{"type":"string","description":"An action link to refund the full settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/full/{linkData}"}}},"cardPayments:partialRefund":{"type":"object","description":"An action link to refund a portion of the settled amount.","properties":{"href":{"type":"string","description":"An action link to refund a portion of the settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/partials/{linkData}"}}},"cardPayments:reverse":{"type":"object","description":"An action link to cancel or refund the full amount.","properties":{"href":{"type":"string","description":"An action link to cancel or refund the full amount.","example":"https://try.access.worldpay.com/payments/sales/reversals/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_partialSettle":{"id":"components/schemas/payments_links_list_partialSettle","kind":"json-schema","title":"payments_links_list_partialSettle","data":{"type":"object","properties":{"cardPayments:refund":{"type":"object","description":"An action link to refund the full settled amount.","properties":{"href":{"type":"string","description":"An action link to refund the full settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/full/{linkData}"}}},"cardPayments:partialRefund":{"type":"object","description":"An action link to refund a portion of the settled amount.","properties":{"href":{"type":"string","description":"An action link to refund a portion of the settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/partials/{linkData}"}}},"cardPayments:partialSettle":{"type":"object","description":"An action link to send a portion of the authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send a portion of the authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/partials/{linkData}"}}},"cardPayments:cancel":{"type":"object","description":"An action link to cancel the full authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel the full authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/{linkData}"}}},"cardPayments:reverse":{"type":"object","description":"An action link to cancel or refund the full amount.","properties":{"href":{"type":"string","description":"An action link to cancel or refund the full amount.","example":"https://try.access.worldpay.com/payments/sales/reversals/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_fullSettle":{"id":"components/schemas/payments_links_list_fullSettle","kind":"json-schema","title":"payments_links_list_fullSettle","data":{"type":"object","properties":{"cardPayments:refund":{"type":"object","description":"An action link to refund the full settled amount.","properties":{"href":{"type":"string","description":"An action link to refund the full settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/full/{linkData}"}}},"cardPayments:partialRefund":{"type":"object","description":"An action link to refund a portion of the settled amount.","properties":{"href":{"type":"string","description":"An action link to refund a portion of the settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/partials/{linkData}"}}},"cardPayments:reverse":{"type":"object","description":"An action link to cancel or refund the full amount.","properties":{"href":{"type":"string","description":"An action link to cancel or refund the full amount.","example":"https://try.access.worldpay.com/payments/sales/reversals/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_partialRefund":{"id":"components/schemas/payments_links_list_partialRefund","kind":"json-schema","title":"payments_links_list_partialRefund","data":{"type":"object","properties":{"cardPayments:partialRefund":{"type":"object","description":"An action link to refund a portion of the settled amount.","properties":{"href":{"type":"string","description":"An action link to refund a portion of the settled amount.","example":"https://try.access.worldpay.com/payments/settlements/refunds/partials/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_fullRefund":{"id":"components/schemas/payments_links_list_fullRefund","kind":"json-schema","title":"payments_links_list_fullRefund","data":{"type":"object","properties":{"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_partialCancel":{"id":"components/schemas/payments_links_list_partialCancel","kind":"json-schema","title":"payments_links_list_partialCancel","data":{"type":"object","properties":{"cardPayments:cancel":{"type":"object","description":"An action link to cancel the full authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel the full authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/{linkData}"}}},"cardPayments:partialCancel":{"type":"object","description":"An action link to cancel a portion of the authorized amount.","properties":{"href":{"type":"string","description":"An action link to cancel a portion of the authorized amount.","example":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/{linkData}"}}},"cardPayments:settle":{"type":"object","description":"An action link to send the full authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send the full authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/full/{linkData}"}}},"cardPayments:partialSettle":{"type":"object","description":"An action link to send a portion of the authorized amount for settlement.","properties":{"href":{"type":"string","description":"An action link to send a portion of the authorized amount for settlement.","example":"https://try.access.worldpay.com/payments/settlements/partials/{linkData}"}}},"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_fullCancel":{"id":"components/schemas/payments_links_list_fullCancel","kind":"json-schema","title":"payments_links_list_fullCancel","data":{"type":"object","properties":{"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_links_list_reversal":{"id":"components/schemas/payments_links_list_reversal","kind":"json-schema","title":"payments_links_list_reversal","data":{"type":"object","properties":{"cardPayments:events":{"type":"object","description":"An action link to retrieve the last event of the payment.","properties":{"href":{"type":"string","description":"An action link to retrieve the last event of the payment.","example":"https://try.access.worldpay.com/payments/events/{linkData}"}}}}}},"components/schemas/payments_authorize_201_response":{"id":"components/schemas/payments_authorize_201_response","kind":"json-schema","title":"payments_authorize_201_response","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outcome of the request. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Sent for Settlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is enabled in the request."},"children":[]}]}]}]},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"exemption":{"$ref":"#/components/schemas/exemptionOutcome"},"issuer":{"$ref":"#/components/schemas/issuer"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"},"amounts":{"$ref":"#/components/schemas/amounts"},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"scheme":{"$ref":"#/components/schemas/scheme"},"_links":{"$ref":"#/components/schemas/payments_links_list_authorized"}}}},"components/schemas/payments_sentForSettlement_201_response":{"id":"components/schemas/payments_sentForSettlement_201_response","kind":"json-schema","title":"payments_sentForSettlement_201_response","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outcome of the request. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Sent for Settlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is enabled in the request."},"children":[]}]}]}]},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"exemption":{"$ref":"#/components/schemas/exemptionOutcome"},"issuer":{"$ref":"#/components/schemas/issuer"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"scheme":{"$ref":"#/components/schemas/scheme"},"_links":{"$ref":"#/components/schemas/payments_links_list_sentForSettlement"}}}},"components/schemas/payments_authorize_201_refusal":{"id":"components/schemas/payments_authorize_201_refusal","kind":"json-schema","title":"payments_authorize_201_refusal","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":"Outcome of the request."},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"exemption":{"$ref":"#/components/schemas/exemptionOutcome"},"refusalCode":{"type":"string","description":"Response code for the payment authorization request."},"gatewayRefusalCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Extended refusal code generated by us, returned only for merchants configured to receive raw scheme response codes in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refusalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}]},"refusalDescription":{"type":"string","description":"Additional context on the refusal."},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"advice":{"$ref":"#/components/schemas/advice"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"}}}},"components/schemas/payments_authorize_201_response_mit":{"id":"components/schemas/payments_authorize_201_response_mit","kind":"json-schema","title":"payments_authorize_201_response_mit","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outcome of the request. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Sent for Settlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is enabled in the request."},"children":[]}]}]}]},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"issuer":{"$ref":"#/components/schemas/issuer"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"},"amounts":{"$ref":"#/components/schemas/amounts"},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"scheme":{"$ref":"#/components/schemas/scheme"},"_links":{"$ref":"#/components/schemas/payments_links_list_authorized"}}}},"components/schemas/payments_sentForSettlement_201_response_mit":{"id":"components/schemas/payments_sentForSettlement_201_response_mit","kind":"json-schema","title":"payments_sentForSettlement_201_response_mit","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outcome of the request. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Sent for Settlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestAutoSettlement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is enabled in the request."},"children":[]}]}]}]},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"issuer":{"$ref":"#/components/schemas/issuer"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"scheme":{"$ref":"#/components/schemas/scheme"},"_links":{"$ref":"#/components/schemas/payments_links_list_sentForSettlement"}}}},"components/schemas/payments_authorize_201_refusal_mit":{"id":"components/schemas/payments_authorize_201_refusal_mit","kind":"json-schema","title":"payments_authorize_201_refusal_mit","data":{"required":["outcome"],"type":"object","properties":{"outcome":{"type":"string","description":"Outcome of the request."},"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"refusalCode":{"type":"string","description":"Response code for the payment authorization request."},"gatewayRefusalCode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Extended refusal code generated by us, returned only for merchants configured to receive raw scheme response codes in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refusalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}]},"refusalDescription":{"type":"string","description":"Additional context on the refusal."},"riskFactors":{"$ref":"#/components/schemas/riskFactors"},"advice":{"$ref":"#/components/schemas/advice"},"paymentInstrument":{"$ref":"#/components/schemas/responsePaymentInstrument"},"updatedPaymentInstrument":{"$ref":"#/components/schemas/updatedPaymentInstrument"}}}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"type":"object","properties":{"errorName":{"type":"string"},"message":{"type":"string"}}}},"components/schemas/ValidationErrorResponse":{"id":"components/schemas/ValidationErrorResponse","kind":"json-schema","title":"ValidationErrorResponse","data":{"type":"object","properties":{"errorName":{"type":"string"},"message":{"type":"string"},"validationErrors":{"type":"array","description":"Further error details","items":{"type":"object","properties":{"errorName":{"type":"string"},"message":{"type":"string"},"jsonPath":{"type":"string"}}}}}}},"components/schemas/payments_partialSettle":{"id":"components/schemas/payments_partialSettle","kind":"json-schema","title":"payments_partialSettle","data":{"required":["value","reference"],"type":"object","properties":{"reference":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[-A-Za-z0-9]*$","description":"A reference generated by you to identify a payment throughout its lifecycle.","example":"partial-settle-reference"},"value":{"allOf":[{"$ref":"#/components/schemas/value"},{"type":"object","properties":{"surchargeAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing the processing and service fees. Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is included in the partial settlement amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100, then the actual cost of goods/services is $80."},"children":[]}]}]}]}}}]},"merchant":{"type":"object","description":"Contains information about the merchant.","properties":{"taxReference":{"type":"string","description":"Merchant's tax reference."},"marketplace":{"type":"object","description":"Supply additional data for marketplace use cases.","properties":{"sellerCountryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]{2}$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your seller's country code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required if the seller is located in a different country to the marketplace's domicile."},"children":[]}]}]}],"example":"FR"},"splitFundingReference":{"maxLength":256,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"A reference that you can use to split acquiring funding into your secondary bank account. Available for marketplaces and other merchant types. Not available for North America or Latin America payments. Contact your Worldpay Implementation Manager to enable."}}}}},"customer":{"type":"object","description":"Additional customer data.","properties":{"reference":{"type":"string","description":"Merchant-generated customer reference."}}},"shipping":{"$ref":"#/components/schemas/shipping"},"order":{"$ref":"#/components/schemas/order"},"industryData":{"$ref":"#/components/schemas/industryData"},"sequence":{"type":"object","required":["number","total"],"description":"The sequence number and total number of expected partial settlement requests for the payment.","properties":{"number":{"type":"integer"},"total":{"type":"integer"}}}}}},"components/schemas/payments_settle":{"id":"components/schemas/payments_settle","kind":"json-schema","title":"payments_settle","data":{"type":"object","properties":{"reference":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[-A-Za-z0-9]*$","description":"A reference generated by you to identify a payment throughout its lifecycle.","example":"full-settle-reference"},"value":{"type":"object","description":"An object that contains information about the value of the payment.","properties":{"surchargeAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing processing and service fees. Ensure that the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" complies with local regulations and card network rules before applying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The surcharge fee is included in the total transaction amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20 and the total authorization amount was $100, then the actual cost of goods/services is 80."},"children":[]}]}]}]}}},"merchant":{"type":"object","description":"Contains information about the merchant.","properties":{"taxReference":{"type":"string","description":"Merchant's tax reference."}}},"customer":{"type":"object","description":"Additional customer data.","properties":{"reference":{"type":"string","description":"Merchant-generated customer reference."}}},"shipping":{"$ref":"#/components/schemas/shipping"},"order":{"$ref":"#/components/schemas/order"},"industryData":{"$ref":"#/components/schemas/industryData"}}}},"components/schemas/payments_partialSettle_response":{"id":"components/schemas/payments_partialSettle_response","kind":"json-schema","title":"payments_partialSettle_response","data":{"type":"object","properties":{"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"_links":{"$ref":"#/components/schemas/payments_links_list_partialSettle"}}}},"components/schemas/payments_fullSettle_response":{"id":"components/schemas/payments_fullSettle_response","kind":"json-schema","title":"payments_fullSettle_response","data":{"type":"object","properties":{"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"_links":{"$ref":"#/components/schemas/payments_links_list_fullSettle"}}}},"components/schemas/payments_partialRefund_response":{"id":"components/schemas/payments_partialRefund_response","kind":"json-schema","title":"payments_partialRefund_response","data":{"type":"object","properties":{"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"_links":{"$ref":"#/components/schemas/payments_links_list_partialRefund"}}}},"components/schemas/payments_fullRefund_response":{"id":"components/schemas/payments_fullRefund_response","kind":"json-schema","title":"payments_fullRefund_response","data":{"type":"object","properties":{"paymentId":{"$ref":"#/components/schemas/paymentId"},"commandId":{"$ref":"#/components/schemas/commandId"},"_links":{"$ref":"#/components/schemas/payments_links_list_fullRefund"}}}},"components/schemas/payments_partialCancel_response":{"id":"components/schemas/payments_partialCancel_response","kind":"json-schema","title":"payments_partialCancel_response","data":{"type":"object","properties":{"_links":{"$ref":"#/components/schemas/payments_links_list_partialCancel"}}}},"components/schemas/payments_fullCancel_response":{"id":"components/schemas/payments_fullCancel_response","kind":"json-schema","title":"payments_fullCancel_response","data":{"type":"object","properties":{"_links":{"$ref":"#/components/schemas/payments_links_list_fullCancel"}}}},"components/schemas/payments_reversal_response":{"id":"components/schemas/payments_reversal_response","kind":"json-schema","title":"payments_reversal_response","data":{"type":"object","properties":{"_links":{"$ref":"#/components/schemas/payments_links_list_reversal"}}}},"components/schemas/payments_increaseAuthorize":{"id":"components/schemas/payments_increaseAuthorize","kind":"json-schema","title":"payments_increaseAuthorize","data":{"required":["value"],"type":"object","properties":{"value":{"$ref":"#/components/schemas/value"}}}},"components/schemas/payments_increaseAuthorize_response":{"id":"components/schemas/payments_increaseAuthorize_response","kind":"json-schema","title":"payments_increaseAuthorize_response","data":{"type":"object","properties":{"outcome":{"type":"string","description":"Outcome of the request.","example":"authorized"},"amounts":{"type":"object","description":"An object containing transaction amounts.","properties":{"totalAuthorized":{"type":"integer","description":"The total amount authorized. The sum of the original estimated authorization and all subsequent successful requests to increase the authorized amount."},"currency":{"type":"string","maxLength":3,"minLength":3,"pattern":"^[A-Z]$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The three character currency code. See list of "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"a","attrs":{"href":"/access/products/reference/supported-countries-currencies#iso-currency-codes"}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supported currencies"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"}}},"issuer":{"$ref":"#/components/schemas/issuer"},"scheme":{"$ref":"#/components/schemas/scheme"},"_links":{"$ref":"#/components/schemas/payments_links_list_increaseAuthorizedAmount"}}}},"components/schemas/payments_increaseAuthorize_response_refused":{"id":"components/schemas/payments_increaseAuthorize_response_refused","kind":"json-schema","title":"payments_increaseAuthorize_response_refused","data":{"type":"object","properties":{"outcome":{"type":"string","description":"Outcome of the request."},"refusalCode":{"type":"string","description":"Response code for the request to increase the authorized amount."},"refusalDescription":{"type":"string","description":"Additional context on the refusal.","example":"Insufficient Funds"}}}},"components/schemas/payments_cancel":{"id":"components/schemas/payments_cancel","kind":"json-schema","title":"payments_cancel","data":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[-A-Za-z0-9]*$","description":"A reference generated by you to identify a payment throughout its lifecycle.","example":"full-cancellation-reference"}}}},"components/schemas/payments_partialCancel":{"id":"components/schemas/payments_partialCancel","kind":"json-schema","title":"payments_partialCancel","data":{"required":["value","reference"],"type":"object","properties":{"reference":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[-A-Za-z0-9]*$","description":"A reference generated by you to identify a payment throughout its lifecycle.","example":"partial-cancellation-reference"},"value":{"$ref":"#/components/schemas/value"}}}},"components/schemas/payments_refund":{"id":"components/schemas/payments_refund","kind":"json-schema","title":"payments_refund","data":{"type":"object","properties":{"reference":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[-A-Za-z0-9]*$","description":"An optional reference generated by you to identify a payment throughout its lifecycle.","example":"refund-reference"},"fastRefund":{"type":"object","description":"Allows you to request a faster refund.","required":["enabled"],"properties":{"enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to request fast refund."},"children":[]}]}]}]},"fallbackToStandard":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fall back to standard refund processing in case the fast refund fails. Must be present if fast refund is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}}}}},"components/schemas/payments_partialRefund":{"id":"components/schemas/payments_partialRefund","kind":"json-schema","title":"payments_partialRefund","data":{"required":["value","reference"],"type":"object","properties":{"reference":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[-A-Za-z0-9]*$","description":"A reference generated by you to identify a payment throughout its lifecycle.","example":"partial-refund-reference"},"value":{"allOf":[{"$ref":"#/components/schemas/value"},{"type":"object","properties":{"surchargeAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing processing and service fees of the original transaction."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The surcharge fee is included in the partial refund amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.surchargeAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was $100, then the actual cost of goods/services was $80."},"children":[]}]}]}]},"convenienceAmount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charging amount representing the offer of a convenient payment method or channel (such as online booking fee) of the original transaction."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Convenience fee is included in the partial refund amount, e.g. if the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.convenienceAmount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was $20 and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was $100, then the actual cost of goods/services was $80."},"children":[]}]}]}]}}}]},"merchant":{"type":"object","description":"Contains information about the merchant.","properties":{"marketplace":{"type":"object","description":"Supply additional data for marketplace use cases.","properties":{"splitFundingReference":{"maxLength":256,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"A reference that you can use to split acquiring funding into your secondary bank account. Available for marketplaces and other merchant types. Not available for North America or Latin America payments. Contact your Worldpay Implementation Manager to enable."}}}}},"fastRefund":{"type":"object","description":"Allows you to request a faster refund.","required":["enabled"],"properties":{"enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to request fast refund."},"children":[]}]}]}]},"fallbackToStandard":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to fall back to standard refund processing in case the fast refund fails. Must be present if fast refund is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}}}}},"components/schemas/payments_events_200_response":{"id":"components/schemas/payments_events_200_response","kind":"json-schema","title":"payments_events_200_response","data":{"required":["lastEvent"],"type":"object","properties":{"lastEvent":{"type":"string","enum":["Authorized","Refused","Sent for Settlement","Sent for Refund","Sent for Cancellation","Refund failed","Settlement failed","Settled","Refunded","Error","Expired"],"x-enumDescriptions":{"Authorized":"The payment has been approved and the funds have been reserved in your customer's account.","Refused":"Your payment request has been declined.","Sent for Settlement":"A request has been made to move the reserved funds in your customer's account and transfer them to your Worldpay account.","Sent for Refund":"A request has been made to send funds back to your customer's account.","Sent for Cancellation":"A request has been made to cancel the payment without sending it for settlement.","Refund failed":"A refund request couldn't be processed and the funds were returned to your account.","Settlement failed":"A settlement request couldn't be processed. Funds have not been transferred to your Worldpay account.","Settled":"We have received the funds and are preparing to transfer them to your bank account. This event is only available in certain use cases.","Refunded":"The card issuer has received the refund request and they will return the funds to your customer's account. This event is only available in certain use cases.","Error":"The payment wasn't completed. You may want to reattempt the payment.","Expired":"The authorization validity period ended before a settlement or cancel request was made."}}}}},"components/schemas/payments_events_recovery_200_response":{"id":"components/schemas/payments_events_recovery_200_response","kind":"json-schema","title":"payments_events_recovery_200_response","data":{"required":["lastEvent"],"type":"object","properties":{"lastEvent":{"type":"string","enum":["Authorized","Refused","Sent for Settlement","Sent for Refund","Send for Cancellation","Refund failed","Settlement failed","Settled","Refunded","Error","Expired"],"x-enumDescriptions":{"Authorized":"The payment has been approved and the funds have been reserved in your customer's account.","Refused":"Your payment request has been declined.","Sent for Settlement":"A request has been made to move the reserved funds in your customer's account and transfer them to your Worldpay account.","Sent for Refund":"A request has been made to send funds back to your customer's account.","Sent for Cancelation":"A request has been made to cancel the payment without sending it for settlement.","Refund failed":"A refund request couldn't be processed and the funds were returned to your account.","Settlement failed":"A settlement request couldn't be processed. Funds have not been transferred to your Worldpay account.","Settled":"We have received the funds and are preparing to transfer them to your bank account. This event is only available in certain use cases.","Refunded":"The card issuer has received the refund request and they will return the funds to your customer's account. This event is only available in certain use cases.","Error":"The payment wasn't completed. You may want to reattempt the payment.","Expired":"The authorization validity period ended before a settlement or cancel request was made."}}}}},"components/schemas/responseSchemeReference":{"id":"components/schemas/responseSchemeReference","kind":"json-schema","title":"responseSchemeReference","data":{"type":"string","minLength":1,"maxLength":255,"description":"Used by the card scheme to link merchant initiated transactions (MITs) to the original customer initiated transaction (CIT). Supply the value returned by the card scheme in the original CIT.","example":"446238472410421"}},"components/schemas/responseSupplementaryReference":{"id":"components/schemas/responseSupplementaryReference","kind":"json-schema","title":"responseSupplementaryReference","data":{"type":"string","minLength":1,"maxLength":255,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"admonition","inline":true,"attributes":{"type":"warning","name":"Coming soon"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Preview only. Not yet available in production."},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applies to Mastercard transactions only. A secondary reference used by the card scheme to link merchant initiated transactions (MITs) to the original customer initiated transaction (CIT). Supply the value returned by the card scheme in the original CIT."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please see our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/card-payments/features/mastercard-tlid"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mastercard TLID guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"MCCOLXT1C0104  "}},"components/schemas/cit_subscription":{"id":"components/schemas/cit_subscription","kind":"json-schema","title":"cit_subscription","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer. A subscription plan occurs at fixed time intervals."},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to begin a new subscription."},"children":[]}]}]}],"enum":["first"]}}}},"components/schemas/mit_subscription":{"id":"components/schemas/mit_subscription","kind":"json-schema","title":"mit_subscription","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer. A subscription plan occurs at fixed time intervals."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"}}}},"components/schemas/cit_installment":{"id":"components/schemas/cit_installment","kind":"json-schema","title":"cit_installment","data":{"type":"object","required":["type","installmentType"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"installmentType":{"type":"string","description":"Defines the type of installments service","enum":["merchant","latinAmerica"]},"installmentPlan":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required only for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latinAmerica"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" installment type."},"children":[]}]}]}],"required":["numberOfInstallments"],"properties":{"numberOfInstallments":{"type":"integer","description":"Number of installments that the requested amount should be broken into."}}},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the card on file agreement. Must be set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to begin a new merchant installment (optional for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"latinAmerica"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" installments)."},"children":[]}]}]}],"enum":["first","subsequent"]}}}},"components/schemas/mit_installment":{"id":"components/schemas/mit_installment","kind":"json-schema","title":"mit_installment","data":{"required":["type","installmentType"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"installmentType":{"type":"string","description":"Defines the type of installments service.","enum":["merchant"]}}}},"components/schemas/mit_unscheduled":{"id":"components/schemas/mit_unscheduled","kind":"json-schema","title":"mit_unscheduled","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"}}}},"components/schemas/cit_cardOnFile":{"id":"components/schemas/cit_cardOnFile","kind":"json-schema","title":"cit_cardOnFile","data":{"required":["type","storedCardUsage"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to store a card or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to use a previously stored card."},"children":[]}]}]}],"enum":["first","subsequent"]}}}},"components/schemas/mit_reauthorization":{"id":"components/schemas/mit_reauthorization","kind":"json-schema","title":"mit_reauthorization","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the transaction is using a stored card. If no agreement was made to store your customer's card, omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["subsequent"]}}}},"components/schemas/mit_resubmission":{"id":"components/schemas/mit_resubmission","kind":"json-schema","title":"mit_resubmission","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the transaction is using a stored card. If no agreement was made to store your customer's card, omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["subsequent"]}}}},"components/schemas/mit_noShow":{"id":"components/schemas/mit_noShow","kind":"json-schema","title":"mit_noShow","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the transaction is using a stored card. If no agreement was made to store your customer's card, omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["subsequent"]}}}},"components/schemas/mit_delayedCharge":{"id":"components/schemas/mit_delayedCharge","kind":"json-schema","title":"mit_delayedCharge","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the transaction is using a stored card. If no agreement was made to store your customer's card, omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["subsequent"]}}}},"components/schemas/mit_partialShipment":{"id":"components/schemas/mit_partialShipment","kind":"json-schema","title":"mit_partialShipment","data":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"schemeSupplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the transaction is using a stored card. If no agreement was made to store your customer's card, omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"storedCardUsage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["subsequent"]}}}},"components/schemas/exemption":{"id":"components/schemas/exemption","kind":"json-schema","title":"exemption","data":{"type":"object","required":["type"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object for applying exemptions. If you are applying a TRA (Transaction Risk Assessment) exemption granted by us, use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"riskProfile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object"},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/exemption_external"},{"$ref":"#/components/schemas/exemption_authentication-outage"}],"discriminator":{"propertyName":"type","mapping":{"external":"#/components/schemas/exemption_external","authenticationOutage":"#/components/schemas/exemption_authentication-outage"}}}},"components/schemas/exemption_external":{"id":"components/schemas/exemption_external","kind":"json-schema","title":"exemption_external","data":{"allOf":[{"$ref":"#/components/schemas/exemption"}],"type":"object","properties":{"type":{"$ref":"#/components/schemas/exemption_type"},"request":{"type":"object","description":"The type of exemption to apply","properties":{"placement":{"enum":["authorization","authentication"],"x-enumDescriptions":{"authorization":"Apply the exemption in the payment authorization","authentication":"The exemption has been applied in 3DS authentication"},"type":"string","description":"Indicates whether the exemption should be placed in a payment authorization or 3DS authentication.\n"},"type":{"enum":["lowValue","lowRisk"],"x-enumDescriptions":{"lowValue":"Apply a lowValue exemption (authorization exemption only)","lowRisk":"Apply a lowRisk exemption"},"type":"string","description":"The type of exemption to apply."}}}}}},"components/schemas/exemption_authentication-outage":{"id":"components/schemas/exemption_authentication-outage","kind":"json-schema","title":"exemption_authentication-outage","data":{"allOf":[{"$ref":"#/components/schemas/exemption"}],"type":"object","properties":{"type":{"$ref":"#/components/schemas/exemption_type"}}}},"components/schemas/exemption_type":{"id":"components/schemas/exemption_type","kind":"json-schema","title":"exemption_type","data":{"type":"string","x-enumDescriptions":{"external":"TRA (Transaction Risk Assessment) exemption provided by a 3rd party provider","authenticationOutage":"Apply an exemption for recognized downstream 3DS authentication failures. This will increase the likelihood of receiving a successful authorization, but will not provide liability shift."}}},"components/schemas/fundsTransfer":{"id":"components/schemas/fundsTransfer","kind":"json-schema","title":"fundsTransfer","data":{"type":"object","description":"Contains details of the funds transfer request, which is a money movement for a reason other than the purchase of goods or services (also known as Account Funding Transaction (AFT)).","required":["type"],"properties":{"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the type of the funds transfer. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"admonition","inline":true,"attributes":{"type":"warning","name":"Note"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You may only submit the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fundsTransfer.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values that relate to the use cases that you have been approved for by the schemes."},"children":[]}]}]}]}],"enum":["accountToAccount","cash","disbursement","personToPerson","purchase","topUp","walletLoad"],"type":"string","x-enumDescriptions":{"accountToAccount":"Move funds to another financial institution account owned by the same person","cash":"A card is used to fund a transfer where funds are given to the recipient in cash","disbursement":"A card is used as the source of funds for a disbursement","personToPerson":"Move funds to an account owned by another person (eg gifts)","purchase":"For the initial purchase of a reloadable account (such as prepaid or gift card), or direct crypto and liquid asset purchases without an intermediary wallet load","topUp":"Top up a pre-paid or debit card","walletLoad":"Move funds to a digital wallet owned by the same person"}},"purpose":{"description":"Specifies the purpose of the funds transfer. Required for some regions and use cases (e.g. crypto).","enum":["businessToBusiness","creditCardRepayment","crypto","crowdLending","debitCard","education","emergency","familySupport","gift","giftCard","gaming","highRiskSecurities","liquidAssets","medical","payroll","prepaidCard","salary","savings","travel","other","stablecoin","cbdc","nft","blockchainNativeToken"],"x-enumDescriptions":{"businessToBusiness":"Business to business","creditCardRepayment":"Credit card repayment","crypto":"Cryptocurrency","crowdLending":"Crowd lending","debitCard":"Debit card","education":"Education","emergency":"Emergency","familySupport":"Family support","gift":"Gift","giftCard":"Gift card","gaming":"Gaming","highRiskSecurities":"High risk securities","liquidAssets":"Liquid assets","medical":"Medical","payroll":"Payroll","prepaidCard":"Prepaid card","salary":"Salary","savings":"Savings","travel":"Travel","other":"Other","stablecoin":"Stablecoin (for ramp providers only)","cbdc":"Central bank digital currency (for ramp providers only)","nft":"Non-fungible token (for ramp providers only)","blockchainNativeToken":"Blockchain native token (for ramp providers only)"},"type":"string"},"recipient":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object containing details about the recipient of funds, including name and address information, as well as recipient account details. In many use cases, the recipient is the same person as the sender (for example if your customer uses their card to load funds into their own crypto exchange or investment account). "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Although an optional object in the API schema, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recipient"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required for some regions and use cases."},"children":[]}]}]}]}],"properties":{"account":{"type":"object","description":"An object for the account details of the recipient.","oneOf":[{"$ref":"#/components/schemas/fundsTransfer_bankAccount"},{"$ref":"#/components/schemas/fundsTransfer_card"},{"$ref":"#/components/schemas/fundsTransfer_wallet"},{"$ref":"#/components/schemas/fundsTransfer_storedValueWallet"},{"$ref":"#/components/schemas/fundsTransfer_stagedDigitalWallet"},{"$ref":"#/components/schemas/fundsTransfer_merchantWallet"},{"$ref":"#/components/schemas/fundsTransfer_email"},{"$ref":"#/components/schemas/fundsTransfer_phone"},{"$ref":"#/components/schemas/fundsTransfer_socialNetwork"}],"discriminator":{"propertyName":"type","mapping":{"bankAccount":"#/components/schemas/fundsTransfer_bankAccount","card":"#/components/schemas/fundsTransfer_card","wallet":"#/components/schemas/fundsTransfer_wallet","storedValueWallet":"#/components/schemas/fundsTransfer_storedValueWallet","stagedDigitalWallet":"#/components/schemas/fundsTransfer_stagedDigitalWallet","merchantWallet":"#/components/schemas/fundsTransfer_merchantWallet","email":"#/components/schemas/fundsTransfer_email","phone":"#/components/schemas/fundsTransfer_phone","socialNetwork":"#/components/schemas/fundsTransfer_socialNetwork"}}},"firstName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Recipient's first name. Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middleName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided."},"children":[]}]}]}]},"middleName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Recipient's middle name."},"lastName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Recipient's last name. Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"firstName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middleName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided."},"children":[]}]}]}]},"address":{"type":"object","description":"The recipient's address.","properties":{"address1":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"address2":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"city":{"maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"1-3 alphanumeric characters and spaces."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Country code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"required":["countryCode"]},"dateOfBirth":{"type":"object","description":"Recipient's date of birth.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"phoneNumber":{"type":"string","description":"Recipient's phone number.","maxLength":20,"minLength":3,"pattern":"^[0-9 ()+\\-/.x]*$"},"documentReference":{"maxLength":25,"minLength":1,"type":"string","description":"Recipient's document reference (e.g. Tax ID).","pattern":"^[A-Za-z0-9\\-\\/+.()]*$"}}},"sender":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object containing details about the sender of funds, including name and address information. The sender account is always the card account declared within "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instruction.paymentInstrument"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Although an optional object in the API schema, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sender"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required for some regions and use cases."},"children":[]}]}]}]}],"properties":{"firstName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sender's first name. Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middleName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided."},"children":[]}]}]}]},"middleName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Sender's middle name."},"lastName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sender's last name. Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"firstName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middleName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided."},"children":[]}]}]}]},"address":{"type":"object","description":"The sender's address.","properties":{"address1":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"address2":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"city":{"maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be supplied if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"1-3 alphanumeric characters and spaces."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Country code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/reference/supported-countries-currencies#iso-country-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 Alpha-2 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"required":["countryCode"]},"dateOfBirth":{"type":"object","description":"Sender's date of birth.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"documentReference":{"maxLength":25,"minLength":1,"type":"string","description":"Sender's document reference (e.g. Tax ID)."}}}}}},"components/schemas/fundsTransfer_bankAccount":{"id":"components/schemas/fundsTransfer_bankAccount","kind":"json-schema","title":"fundsTransfer_bankAccount","data":{"type":"object","properties":{"type":{"enum":["bankAccount"],"type":"string"},"identifierType":{"type":"string","enum":["iban","swift","routingNumber","accountNumber"]},"iban":{"maxLength":34,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The International Bank Account Number (IBAN) of the recipient. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifierType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"iban"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"IE12BOFI90000112345678"},"accountNumber":{"maxLength":39,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account number of the recipient. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifierType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"routingNumber"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accountNumber"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Visa requires the value to be a maximum of 34 characters."},"children":[]}]}]}],"example":"01234567"},"swiftBic":{"maxLength":11,"minLength":8,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The SWIFT Bank Identification Code (BIC) of the recipient. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifierType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be either 8 or 11 alphanumeric characters."},"children":[]}]}]}],"example":"BEASUS33xxx"},"routingNumber":{"maxLength":9,"minLength":9,"pattern":"^[0-9]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ABA (American Bankers Association) Routing Transit Number (RTN). Identifies the Financial Insititution of the recipient's account. Required if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identifierType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"routingNumber"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be 9 numeric characters."},"children":[]}]}]}],"example":"111000025"}},"required":["type","identifierType"]}},"components/schemas/fundsTransfer_card":{"id":"components/schemas/fundsTransfer_card","kind":"json-schema","title":"fundsTransfer_card","data":{"type":"object","properties":{"type":{"enum":["card"],"type":"string"},"cardNumber":{"maxLength":19,"minLength":12,"pattern":"^[0-9]*$","type":"string","description":"Recipient's card number."}},"required":["type","cardNumber"]}},"components/schemas/fundsTransfer_email":{"id":"components/schemas/fundsTransfer_email","kind":"json-schema","title":"fundsTransfer_email","data":{"type":"object","properties":{"type":{"enum":["email"],"type":"string"},"emailAddress":{"maxLength":40,"minLength":1,"type":"string","description":"Recipient's email address. Visa requires the value to be a maximum of 34 characters."}},"required":["type","emailAddress"]}},"components/schemas/fundsTransfer_phone":{"id":"components/schemas/fundsTransfer_phone","kind":"json-schema","title":"fundsTransfer_phone","data":{"type":"object","properties":{"type":{"enum":["phone"],"type":"string"},"phoneNumber":{"maxLength":20,"minLength":3,"type":"string","description":"Recipient's phone number.","pattern":"^[0-9 ()+\\-/.x]+$"}},"required":["type","phoneNumber"]}},"components/schemas/fundsTransfer_wallet":{"id":"components/schemas/fundsTransfer_wallet","kind":"json-schema","title":"fundsTransfer_wallet","data":{"type":"object","properties":{"type":{"enum":["wallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[A-Za-z0-9@!£$*#)(+\\-_=.,/:;\"]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]}},"components/schemas/fundsTransfer_storedValueWallet":{"id":"components/schemas/fundsTransfer_storedValueWallet","kind":"json-schema","title":"fundsTransfer_storedValueWallet","data":{"type":"object","properties":{"type":{"enum":["storedValueWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]}},"components/schemas/fundsTransfer_stagedDigitalWallet":{"id":"components/schemas/fundsTransfer_stagedDigitalWallet","kind":"json-schema","title":"fundsTransfer_stagedDigitalWallet","data":{"type":"object","properties":{"type":{"enum":["stagedDigitalWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]}},"components/schemas/fundsTransfer_merchantWallet":{"id":"components/schemas/fundsTransfer_merchantWallet","kind":"json-schema","title":"fundsTransfer_merchantWallet","data":{"type":"object","properties":{"type":{"enum":["merchantWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]}},"components/schemas/fundsTransfer_socialNetwork":{"id":"components/schemas/fundsTransfer_socialNetwork","kind":"json-schema","title":"fundsTransfer_socialNetwork","data":{"type":"object","properties":{"type":{"enum":["socialNetwork"],"type":"string"},"socialNetworkReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying recipient's social network account. Visa requires the value to be a maximum of 34 characters."}},"required":["type","socialNetworkReference"]}},"schema_353":{"kind":"json-schema","data":{"type":"string","example":"application/vnd.worldpay.payments-v7+json"},"id":"schema_353"},"schema_354":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/payments_authorize_201_response"},{"$ref":"#/components/schemas/payments_sentForSettlement_201_response"},{"$ref":"#/components/schemas/payments_authorize_201_refusal"}],"discriminator":{"mapping":{"authorized":"#/components/schemas/payments_authorize_201_response","Sent for Settlement":"#/components/schemas/payments_sentForSettlement_201_response","refused":"#/components/schemas/payments_authorize_201_refusal"},"propertyName":"outcome"}},"id":"schema_354"},"schema_355":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/payments_authorize_201_response_mit"},{"$ref":"#/components/schemas/payments_sentForSettlement_201_response_mit"},{"$ref":"#/components/schemas/payments_authorize_201_refusal_mit"}],"discriminator":{"mapping":{"authorized":"#/components/schemas/payments_authorize_201_response_mit","Sent for Settlement":"#/components/schemas/payments_sentForSettlement_201_response_mit","refused":"#/components/schemas/payments_authorize_201_refusal_mit"},"propertyName":"outcome"}},"id":"schema_355"},"schema_356":{"kind":"json-schema","data":{"type":"string"},"id":"schema_356"},"schema_357":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/payments_increaseAuthorize_response"},{"$ref":"#/components/schemas/payments_increaseAuthorize_response_refused"}],"discriminator":{"mapping":{"authorized":"#/components/schemas/payments_increaseAuthorize_response","refused":"#/components/schemas/payments_increaseAuthorize_response_refused"},"propertyName":"outcome"}},"id":"schema_357"},"schema_358":{"kind":"json-schema","data":{"$ref":"#/components/schemas/transactionReference"},"id":"schema_358"},"schema_359":{"kind":"json-schema","data":{"$ref":"#/components/schemas/entity"},"id":"schema_359"}},"exampleStore":{"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}}},"channel":"ecom"},"key":"Card payment authorization","summary":"Card payment authorization","description":"Payment authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields":{"value":{"transactionReference":"transaction-ref","merchant":{"entity":"default","mcc":"1234","paymentFacilitator":{"schemeId":"12345","independentSalesOrganizationId":"12345","subMerchant":{"name":"Merchant Plc","reference":"12345","address":{"postalCode":"SW1 1AA","street":"Regent Street","city":"London","countryCode":"GB","state":"CA"},"taxReference":"12345","phoneNumber":"0123456789","email":"test@email.com","url":"developer.worldpay.com"}}},"instruction":{"requestAutoSettlement":{"enabled":false},"consumerBillPayment":true,"debtRepayment":true,"narrative":{"line1":"trading name","line2":"order number"},"value":{"currency":"GBP","amount":250,"estimated":true,"acceptPartialAmount":true},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":12,"year":2024},"cardHolderName":"John Appleseed","billingAddress":{"address1":"address line 1","address2":"address line 2","address3":"address line 3","city":"city","state":"state","postalCode":"12345","countryCode":"IT"},"cvc":"123"}},"riskProfile":"https://try.access.worldpay.com/riskProfile/","channel":"ecom"},"key":"Card payment authorization with all optional fields","summary":"Card payment authorization with all optional fields","description":"Payment authorization for GBP 2.50 with all optional fields","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization with all optional fields"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}}},"channel":"ecom","authentication":{"threeDS":{"version":"2.2.0","eci":"05","authenticationValue":"kBNHXUAy4+HT1gAMBSDajheBcxQh","transactionId":"c5b808e7-1de1-4069-a17b-f70d3b3b1645"}}},"key":"Card payment authorization using 3DS2 authentication","summary":"Card payment authorization using 3DS2 authentication","description":"Payment authorization for GBP 2.50 using 3DS2 authentication","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment authorization using 3DS2 authentication"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035},"cvc":"123"},"customerAgreement":{"type":"cardOnFile","storedCardUsage":"first"}},"channel":"ecom"},"key":"Card payment with a request to store card details","summary":"Card payment with a request to store card details","description":"Payment authorization with a request to store card on file","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Card payment with a request to store card details"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/token","href":"https://try.access.worldpay.com/tokens"}},"channel":"ecom"},"key":"Tokenized card payment authorization","summary":"Tokenized card payment authorization","description":"Tokenized card payment authorization","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Tokenized card payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/networkToken","tokenNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}}},"channel":"ecom","authentication":{"networkToken":{"cryptogram":"BLIYQ4EA/wLF4/hK9ABFMAABAAA=","eci":"05"}}},"key":"Network token payment authorization","summary":"Network token payment authorization","description":"Network token payment authorization","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Network token payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/checkout","tokenHref":"https://try.access.worldpay.com/tokens","cvcHref":"https://try.access.worldpay.com/sessions"}},"channel":"ecom"},"key":"Checkout payment authorization","summary":"Checkout payment authorization","description":"Checkout authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Checkout payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/wallet+applepay","walletToken":"token"}},"channel":"ecom"},"key":"Apple wallet payment authorization","summary":"Apple wallet payment authorization","description":"Apple wallet payment authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Apple wallet payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/wallet+googlepay","walletToken":"token"}},"channel":"ecom"},"key":"Google wallet payment authorization","summary":"Google wallet payment authorization","description":"Google wallet payment authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Google wallet payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/networkToken+applepay","tokenNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}}},"channel":"ecom","authentication":{"networkToken":{"cryptogram":"BLIYQ4EA/wLF4/hK9ABFMAABAAA=","eci":"05"}}},"key":"Decrypted Apple Pay authorization","summary":"Decrypted Apple Pay authorization","description":"Decrypted Apple Pay authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Apple Pay authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/networkToken+googlepay","tokenNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}}},"channel":"ecom","authentication":{"networkToken":{"cryptogram":"BLIYQ4EA/wLF4/hK9ABFMAABAAA=","eci":"05"}}},"key":"Decrypted Google Pay authorization","summary":"Decrypted Google Pay authorization","description":"Decrypted Google Pay authorization for GBP 2.50","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Decrypted Google Pay authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization":{"value":{"outcome":"authorized","paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmd-Rjc4HJwnBdj3Ri9v10vT0","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization","summary":"Successful payment authorization","description":"Payment authorization for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount":{"value":{"outcome":"authorized","paymentId":"pay9iX60mh85-FPnv4ccQ9B40","commandId":"cmdwZ5y_rSV1VmjD6CpgCuXG0","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:increaseAuthorizedAmount":{"href":"https://try.access.worldpay.com/payments/authorizations/incrementalAuthorizations/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization with estimated authorization amount","summary":"Successful payment authorization with estimated authorization amount","description":"Payment authorization for estimated GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with estimated authorization amount"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)":{"value":{"outcome":"authorized","paymentId":"pay7FBwk30sgS4fi-Vwapb220","commandId":"cmdvn_du3sDMwls94_xG0a_v0","riskFactors":[{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/network+masked","cardBin":"555555","lastFour":"4444","tokenNumber":"555555******4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"tokens:token":{"href":"https://try.access.worldpay.com/tokens/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization (encrypted wallets)","summary":"Successful payment authorization (encrypted wallets)","description":"Payment authorization for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (encrypted wallets)"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)":{"value":{"outcome":"authorized","paymentId":"payM39vAj85naVjwpP28C3800","commandId":"cmdRTc29vnWi5-so71qzfN900","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/network+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization (network tokens and decrypted wallets)","summary":"Successful payment authorization (network tokens and decrypted wallets)","description":"Payment authorization for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (network tokens and decrypted wallets)"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)":{"value":{"outcome":"Sent for Settlement","paymentId":"pay-Tb29_shVbNM2_78s_hLu0","commandId":"cmdCG2tN9863bNw79xB23f7R0","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:refund":{"href":"https://try.access.worldpay.com/payments/settlements/refunds/full/linkData"},"cardPayments:partialRefund":{"href":"https://try.access.worldpay.com/payments/settlements/refunds/partials/linkData"},"cardPayments:reverse":{"href":"https://try.access.worldpay.com/payments/sales/reversals/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization (requestAutoSettlement enabled)","summary":"Successful payment authorization (requestAutoSettlement enabled)","description":"Payment authorization (requestAutoSettlement enabled) for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization (requestAutoSettlement enabled)"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount":{"value":{"outcome":"authorized","paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmd_83bNq9Df_-x32M-9sB4c0","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T75725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"amounts":{"requested":250,"totalAuthorized":199,"currency":"GBP","partialAuthorization":true},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization for a partial amount","summary":"Successful payment authorization for a partial amount","description":"Payment authorization for GBP 2.50 with a successful outcome and GBP 1.99 authorized","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization for a partial amount"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID":{"value":{"outcome":"authorized","paymentId":"pay54dv9St0PlMpsDLMU03x30","commandId":"cmd8f3gT826h7DdaR9ww89r30","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"T15431"},"scheme":{"reference":"aRyU-3Ti981f_6WvBaqM03","supplementaryReference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/linkData"},"cardPayments:partialCancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/linkData"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/linkData"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/linkData"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/linkData"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization with Mastercard TLID","summary":"Successful payment authorization with Mastercard TLID","description":"Payment authorization for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization with Mastercard TLID"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization":{"value":{"outcome":"refused","paymentId":"pay98nf27CWQoNxm3fA6KvdY0","commandId":"cmdtIhnZ-86r1xAam9-v47fB0","refusalCode":"5","refusalDescription":"REFUSED","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"advice":{"code":"01"},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"}},"key":"Refused payment authorization","summary":"Refused payment authorization","description":"Payment authorization with a refused outcome","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error":{"value":{"errorName":"internalServerError","message":"Internal server error"},"key":"Internal server error","summary":"Internal server error","description":"Internal server error","id":"paths/~1cardPayments~1customerInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}},"customerAgreement":{"type":"subscription","schemeReference":"MCCOLXT1C0104  "}}},"key":"Subscriptions - MIT payment authorization","summary":"Subscriptions - MIT payment authorization","description":"MIT authorization for subscriptions","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Subscriptions - MIT payment authorization"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}},"customerAgreement":{"type":"installment","installmentType":"merchant","schemeReference":"MCCOLXT1C0104  "}}},"key":"Installments - MIT payment authorization","summary":"Installments - MIT payment authorization","description":"MIT authorization for installments","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Installments - MIT payment authorization"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"4444333322221111","expiryDate":{"month":5,"year":2035}},"customerAgreement":{"type":"unscheduled","schemeReference":"MCCOLXT1C0104  "}}},"key":"Unscheduled - MIT payment authorization","summary":"Unscheduled - MIT payment authorization","description":"MIT authorization for unscheduled payments","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Unscheduled - MIT payment authorization"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID":{"value":{"transactionReference":"Memory265-13/08/1876","merchant":{"entity":"default"},"instruction":{"requestAutoSettlement":{"enabled":false},"narrative":{"line1":"MindPalace"},"value":{"currency":"GBP","amount":250},"paymentInstrument":{"type":"card/plain","cardNumber":"5454545454545454","expiryDate":{"month":5,"year":2035}},"customerAgreement":{"type":"subscription","schemeReference":"aRyU-3Ti981f_6WvBaqM03","schemeSupplementaryReference":"MCCOLXT1C0104  "}}},"key":"MIT payment authorization with Mastercard TLID","summary":"MIT payment authorization with Mastercard TLID","description":"MIT authorization for a subscription, including the Mastercard TLID","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/MIT payment authorization with Mastercard TLID"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization":{"value":{"outcome":"authorized","paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmdJ3o1eC1o3n6n31ol29l4y0","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"issuer":{"authorizationCode":"675725"},"scheme":{"reference":"MCCOLXT1C0104  "},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"},"_links":{"cardPayments:cancel":{"href":"https://try.access.worldpay.com/payments/authorizations/cancellations/"},"cardPayments:settle":{"href":"https://try.access.worldpay.com/payments/settlements/full/"},"cardPayments:partialSettle":{"href":"https://try.access.worldpay.com/payments/settlements/partials/"},"cardPayments:events":{"href":"https://try.access.worldpay.com/payments/events/"},"curies":[{"name":"cardPayments","href":"https://try.access.worldpay.com/rels/cardPayments/{rel}","templated":true}]}},"key":"Successful payment authorization","summary":"Successful payment authorization","description":"Payment authorization for GBP 2.50 with a successful outcome","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Successful payment authorization"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization":{"value":{"outcome":"refused","paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmd9jCb83Nao1N9noa91dJ200","refusalCode":"5","refusalDescription":"REFUSED","riskFactors":[{"type":"cvc","risk":"notSupplied"},{"type":"avs","risk":"notChecked","detail":"address"},{"type":"avs","risk":"notChecked","detail":"postcode"}],"advice":{"code":"01"},"paymentInstrument":{"type":"card/plain+masked","cardBin":"555555","lastFour":"4444","category":"consumer","countryCode":"GB","expiryDate":{"month":9,"year":2029},"cardBrand":"mastercard","fundingType":"credit","issuerName":"AN ISSUING BANK LTD","paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E"}},"key":"Refused payment authorization","summary":"Refused payment authorization","description":"Payment authorization with a refused outcome","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/201/content/application~1vnd.worldpay.payments-v7+json/examples/Refused payment authorization"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error":{"value":{"errorName":"internalServerError","message":"Internal server error"},"key":"Internal server error","summary":"Internal server error","description":"Internal server error","id":"paths/~1cardPayments~1merchantInitiatedTransactions/post/responses/500/content/application~1vnd.worldpay.payments-v7+json/examples/Internal server error"},"paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization":{"key":"Request to fully settle the authorization","summary":"Request to fully settle the authorization","description":"Request to settle the authorization","id":"paths/~1payments~1settlements~1full~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to fully settle the authorization"},"paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization":{"value":{"paymentId":"payT7hS-8vS4h_95A2f7905v0","commandId":"cmdp9D1t-ENYQxVnJkh0iPRC0","_links":{"cardPayments:refund":{"href":"/payments/settlements/refunds/full/:linkData"},"cardPayments:partialRefund":{"href":"/payments/settlements/refunds/partials/:linkData"},"cardPayments:reverse":{"href":"/payments/authorizations/reversals/:linkData"},"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to fully settle the authorization","summary":"Response to fully settle the authorization","description":"Response to fully settle the authorization","id":"paths/~1payments~1settlements~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to fully settle the authorization"},"paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1settlements~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1settlements~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1settlements~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1settlements~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization":{"value":{"sequence":{"number":1,"total":2},"value":{"amount":500,"currency":"EUR"},"reference":"partial-settle-reference"},"key":"Request to partially settle the authorization","summary":"Request to partially settle the authorization","description":"Request to partially settle the authorization","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"},"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code":{"value":{"sequence":{"number":1,"total":2},"value":{"amount":500,"currency":"EUR"},"reference":"partial-settle-reference","merchant":{"marketplace":{"sellerCountryCode":"FR"}}},"key":"Request to partially settle the authorization, with marketplace seller country code","summary":"Request to partially settle the authorization, with marketplace seller country code","description":"Request to partially settle the authorization","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with marketplace seller country code"},"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference":{"value":{"sequence":{"number":1,"total":2},"value":{"amount":500,"currency":"EUR"},"reference":"partial-settle-reference","merchant":{"marketplace":{"splitFundingReference":"my split funding ref"}}},"key":"Request to partially settle the authorization, with a split funding reference","summary":"Request to partially settle the authorization, with a split funding reference","description":"Request to partially settle the authorization","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization, with a split funding reference"},"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization":{"value":{"paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmdwZ5y_rSi1VmjD6CpgCuXG0","_links":{"cardPayments:refund":{"href":"/payments/settlements/refunds/full/:linkData"},"cardPayments:partialRefund":{"href":"/payments/settlements/refunds/partials/:linkData"},"cardPayments:partialSettle":{"href":"/payments/settlements/partials/:linkData"},"cardPayments:reverse":{"href":"/payments/authorizations/reversals/:linkData"},"cardPayments:cancel":{"href":"/payments/authorizations/cancellations/:linkData"},"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to partially settle the authorization","summary":"Response to partially settle the authorization","description":"Response to partially settle the authorization","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially settle the authorization"},"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1settlements~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization":{"value":{"paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmdwZ5y_rSV1VmjD6CpgCuXG0","_links":{"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to refund an authorization","summary":"Response to refund an authorization","description":"Response to refund an authorization","id":"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to refund an authorization"},"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1settlements~1refunds~1full~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement":{"value":{"value":{"amount":10,"currency":"EUR"},"reference":"partial-refund-reference"},"key":"Request to perform a partial refund of the settlement","summary":"Request to perform a partial refund of the settlement","description":"Request to perform a partial refund of the settlement","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference":{"value":{"value":{"amount":500,"currency":"EUR"},"reference":"partial-refund-reference","merchant":{"marketplace":{"splitFundingReference":"my split funding ref"}}},"key":"Request to perform a partial refund of the settlement, with a split funding reference","summary":"Request to perform a partial refund of the settlement, with a split funding reference","description":"Request to perform a partial refund of the settlement","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to perform a partial refund of the settlement, with a split funding reference"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization":{"value":{"paymentId":"payI-dUcet9fk4_X4qZU0hpU0","commandId":"cmdwZ5y_rSV1VmjD6CpgCuXG0","_links":{"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to partially refund an authorization","summary":"Response to partially refund an authorization","description":"Response to partially refund an authorization","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to partially refund an authorization"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1settlements~1refunds~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization":{"value":{"_links":{"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to cancel an authorization","summary":"Response to cancel an authorization","description":"Response to cancel an authorization","id":"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel an authorization"},"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1authorizations~1cancellations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization":{"value":{"value":{"amount":500,"currency":"EUR"},"reference":"partial-cancel-reference"},"key":"Request to partially settle the authorization","summary":"Request to partially settle the authorization","description":"Request to partially cancel the authorization","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization":{"value":{"_links":{"cardPayments:events":{"href":"/payments/events/:linkData"},"cardPayments:partialCancel":{"href":"/payments/authorizations/cancellations/partials/:linkData"},"cardPayments:partialSettle":{"href":"/payments/settlements/partials/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to cancel partial authorization","summary":"Response to cancel partial authorization","description":"Response to cancel an authorization","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to cancel partial authorization"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1authorizations~1cancellations~1partials~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization":{"value":{"value":{"amount":500,"currency":"EUR"}},"key":"Request to partially settle the authorization","summary":"Request to partially settle the authorization","description":"Request to increase the initial estimated authorization","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/requestBody/content/application~1vnd.worldpay.payments-v7+json/examples/Request to partially settle the authorization"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount":{"value":{"outcome":"authorized","amounts":{"totalAuthorized":1100,"currency":"EUR"},"issuer":{"authorizationCode":"T91252"},"scheme":{"reference":"MCCRU3I5U0701"},"_links":{"cardPayments:increaseAuthorizedAmount":{"href":"/payments/authorizations/incrementalAuthorizations/:linkData"},"cardPayments:cancel":{"href":"/payments/authorizations/cancellations/:linkData"},"cardPayments:partialCancel":{"href":"/payments/authorizations/cancellations/partials/:linkData"},"cardPayments:settle":{"href":"/payments/settlements/full/:linkData"},"cardPayments:partialSettle":{"href":"/payments/settlements/partials/:linkData"},"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Successful response to increase the authorization amount","summary":"Successful response to increase the authorization amount","description":"Successful response to increase an estimated authorization amount","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Successful response to increase the authorization amount"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount":{"value":{"outcome":"refused","refusalCode":"51","refusalDescription":"Insufficient Funds"},"key":"Refused response to increase the authorization amount","summary":"Refused response to increase the authorization amount","description":"Response to increase the authorization amount with a refused outcome due to insufficient funds","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Refused response to increase the authorization amount"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/400/content/aapplication~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1authorizations~1incrementalAuthorizations~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement":{"value":{"_links":{"cardPayments:events":{"href":"/payments/events/:linkData"},"curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Response to reverse the settlement","summary":"Response to reverse the settlement","description":"Response to reverse the settlement","id":"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/202/content/application~1vnd.worldpay.payments-v7+json/examples/Response to reverse the settlement"},"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1sales~1reversals~1{linkData}/post/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference":{"value":{"lastEvent":"Authorized","_links":{"cardPayments:cancel":"/payments/authorizations/cancellations/:linkData","cardPayments:settle":"/payments/settlements/full/:linkData","cardPayments:partialSettle":"/payments/settlements/partials/:linkData","curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Querying a payment event with a transaction reference","summary":"Querying a payment event with a transaction reference","description":"Querying a payment event with a transaction reference","id":"paths/~1payments~1events/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"},"paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1events/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1events/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1events/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1events/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"},"paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference":{"value":{"lastEvent":"Authorized","_links":{"cardPayments:cancel":"/payments/authorizations/cancellations/:linkData","cardPayments:settle":"/payments/settlements/full/:linkData","cardPayments:partialSettle":"/payments/settlements/partials/:linkData","curies":[{"name":"payments","href":"/rels/payments/{rel}","templated":true}]}},"key":"Querying a payment event with a transaction reference","summary":"Querying a payment event with a transaction reference","description":"Querying a payment event with a transaction reference","id":"paths/~1payments~1events~1{linkData}/get/responses/200/content/application~1vnd.worldpay.payments-v7+json/examples/Querying a payment event with a transaction reference"},"paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request":{"value":{"errorName":"bodyDoesNotMatchSchema","message":"The json body provided does not match the expected schema","validationErrors":[{"errorName":"fieldMustBeString","message":"Element at path must be a string","jsonPath":"$.value.currency"}]},"key":"Bad request","summary":"Bad request","description":"Bad request","id":"paths/~1payments~1events~1{linkData}/get/responses/400/content/application~1vnd.worldpay.payments-v7+json/examples/Bad request"},"paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized":{"value":{"errorName":"accessDenied","message":"Access to the requested resource has been denied"},"key":"unauthorized","summary":"unauthorized","description":"Unauthorized","id":"paths/~1payments~1events~1{linkData}/get/responses/401/content/application~1vnd.worldpay.payments-v7+json/examples/unauthorized"},"paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound":{"value":{"errorName":"endpointNotFound","message":"Requested endpoint was not found."},"key":"notFound","summary":"notFound","description":"Not found","id":"paths/~1payments~1events~1{linkData}/get/responses/404/content/application~1vnd.worldpay.payments-v7+json/examples/notFound"},"paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported":{"value":{"errorName":"headerHasInvalidValue","message":"Bad content type"},"key":"unsupported","summary":"unsupported","description":"Unsupported media type","id":"paths/~1payments~1events~1{linkData}/get/responses/415/content/application~1vnd.worldpay.payments-v7+json/examples/unsupported"}},"securitySchemeStore":{"BasicAuth":{"id":"BasicAuth","type":"http","scheme":"basic"}},"servers":[{"url":"https://try.access.worldpay.com","description":"Test (Try)"},{"url":"https://access.worldpay.com","description":"Live"}],"specType":"openapi"},"options":{"jsonSamplesExpandLevel":7,"schemasExpansionLevel":1,"hideSchemaTitles":true,"hidePropertiesPrefix":true,"hideInfoMetadata":true,"codeSamples":{"languages":[{"lang":"Payload"},{"lang":"curl"},{"lang":"Python"},{"lang":"Java"},{"lang":"Node.js"},{"lang":"Go"},{"lang":"PHP"},{"lang":"Ruby"},{"lang":"C#"}]},"hideReplay":false,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/access/_bundle/products/card-payments/@v7/openapi.json?download"},{"url":"/access/_bundle/products/card-payments/@v7/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Card Payments","description":"Take online payments with our Card Payments API.\n\n__Authentication header__\n  ```\n    Authorization: {your_credentials}\n  ```\nReplace `{your_credentials}` with your base64-encoded Basic Auth username and password given to your by your Worldpay Implementation Manager.\n<br /> <br />\n\nYou **must** use the `Authorization` header for any request you send to our Card Payments API.\n\n__Accept/Content-Type header__\n  ```\n  Content-Type: application/vnd.worldpay.payments-v7+json\n  Accept: application/vnd.worldpay.payments-v7+json\n  ```\nWe use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our Card Payments API.\n\nWe require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a `POST` or a `PUT`.\n<br /><br />\n\n\n__DNS whitelisting__  \nWhitelist the following URLs:\n* `https://try.access.worldpay.com/`\n* `https://access.worldpay.com/`\n\nPlease ensure you use DNS whitelisting, not explicit IP whitelisting.","category":["Card Payments","Wallets"],"business":["Enterprise","Marketplaces"],"catalog-list":true,"generated":false}},"baseSlug":"/products/card-payments/openapi","routesMapping":{}}