Start the Payment for a given Order.

Start Payment

Starts a new payment for the given Order with payment details provided to the merchant by the Shopper.

POST /ps/api/public/v1/merchants/{merchant_key}/orders/{order_key}/payments

Identifiers

Name	Type	Description
merchant_key	MerchantKey	The key of the merchant.
order_key	OrderKey	The key of the order.

Parameters

Not applicable.

Request Data

Field	Type	M	Description
method	PaymentMethod	M	The payment method, see below for the list of supported methods. See also the payment method types.
authentication_methods	AuthenticationMethod[]	C	The used authentication methods that successfully authenticated the shopper at the webshop. Required for BanContact WIP, otherwise optional. See also the authentication method types.
ideal_details	Block	O	Deprecated : The payment details when the method is IDEAL.
+ issuer_id	Enum(50)	O	Deprecated : The id of the Issuer Bank. For issuer Ids check List payment methods of an Order
card_details	Block	C	The Card details for following Card Payments: MASTERCARD, VISA, BANCONTACT, V_PAY, MAESTRO, AMEX. Either of plain card details or encrypted card details must be present.
+ browser_information	Block	M	Information about what kind of response Browser accepts, User-Agent, and shopper IP.
++ shopper_ip	String(1, 45)	M	IP of the device from which shopper is making payment. This is an IPv4, IPv6, or an 'IPv4-mapped IPv6' address. The address should match the simple regular expression `[0-9a-fA-F:.]{1,45}`.
++ accept	String(1, 255)	M	Response types which browser accepts like text/html,application/xhtml+xml,application/xml.
++ user_agent	String(1, 255)	M	Browser and Operating System of a System from which Payment is being made. e.g. Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.18363
+ plain_card_details	Block	O	Card details with Card Holder Name, Card Number, Card Expiry date, Security code in plain text format.
++ card_holder_name	String(1, 35)	M	Name of the Card Holder.
++ card_number	String(1, 19)	M	Card Number.
++ card_expiry	Block	M	Card Expiry information including Month and Year.
+++ month	String(2, 2)	M	The month when Card is going to be expired in the future.
+++ year	String(2, 2)	M	The year when Card is going to be expired in the future.
++ security_code	String(3, 4)	C	Security code (CVV/CID/CVC2) on the card. See below when the code is required.
+ encrypted_card_details	Block	O	Card details like Card Holder Name, Card Number, Card Expiry date, Security code in an encrypted format. Check Client Side Encryption for integrating client side encryption with your webshop.
++ data	String (1, 4096)	M	Card details in an encrypted format.
+ three_ri_authentication	Block	O	The 3RI authentication details. Check 3RI Authentication
elv_payment_details	Block	C	The payment details when the method is ELV.
+ iban	String(1, 35)	M	The IBAN of the shopper.
bank_transfer_details	Block	C	The payment details when the method is Bank Transfer.
+ email_address	String(1, 200)	M	The email address of shopper to send bank details.
sepa_direct_debit_details	Block	C	The payment details when the method is Sepa Direct Debit.
+ mandate_number	String(1, 35)	C	The mandate number. Mandatory when IBAN is not provided.
+ iban	String(5, 34)	C	The IBAN of the shopper. Mandatory when mandate number is not provided.
+ bic	String(8, 11)	O	The BIC of the shopper bank account. Can only be provided along with IBAN and not with mandate number.
point_of_sale_details	Block	C	The payment details when the method is POINT_OF_SALE
+ terminal_id	String(1, 35)	M	The terminal_id of the merchant.
inthree_details	Block	C	The payment details when the method is IN3.
+ shopper_ip	String(1, 45)	M	IP of the device from which shopper is making payment. This is an IPv4, IPv6, or an 'IPv4-mapped IPv6' address. The address should match the simple regular expression `[0-9a-fA-F:.]{1,45}`.
token_details	Block	C	Details of this block can be found under Tokenization.
request_shopper_details	Enum[]	C	Details of shopper data the merchant wants to request when the method is IDEAL.

Note: Either browser_information or three_ri_authentication must be present in the card details.

The security code is :

required when using Amex, MasterCard, or Visa as payment method;
optional when using Maestro, VPay, or BanContact as payment method;
not required when submitting the credit card payment as moto-payment;
not required when submitting the credit card payment with 3RI authentication.

Supported request shopper details values:

Enum Value	Notes
NAME	The name of the shopper.(Both First name and Last name)
PHONE	The phone number of the shopper.
EMAIL	The email of the shopper.
SHIPPING_ADDRESS	The Shipping address of the shopper.
BILLING_ADDRESS	The Billing address of the shopper.

Supported payment methods:

Payment Method	API Enum Value	Notes
iDEAL	IDEAL	See note 1 below.
PayPal	PAYPAL	No additional details needed.
MasterCard	MASTERCARD	See note 2 below.
Maestro	MAESTRO	See note 2 below.
American Express	AMEX	See note 2 below.
Visa	VISA	See note 2 below.
V-Pay	V_PAY	See note 2 below.
BanContact	BANCONTACT	See note 2 below.
Bancontact WIP	TOKEN	See note 3 below.
IN3	IN_THREE
Klarna Smoooth	KLARNA	No additional details needed.
Przeleway 24	PRZELEWY_24	No additional details needed.
BLIK	BLIK	No additional details needed.
ELV	ELV
Sofort Ueberweisung	SOFORT_UEBERWEISUNG	No additional details needed.
Ebanking	EBANKING	No additional details needed.
Bank Transfer	BANK_TRANSFER
Sepa Direct Debit	SEPA_DIRECT_DEBIT
Point of Sale (POS)	POINT_OF_SALE
KBC	KBC	No additional details needed.
CBC	CBC	No additional details needed.
Tokenized Payment	TOKEN	See note 3 below.

Notes:

The request_shopper_details can be provided for IDeal Fast Checkout. See iDEAL.
For credit and debit card payments (MasterCard, Maestro, American Express, Visa, V-Pay, and BanContact) it is strongly recommended to use encrypted card details for increased security. The use of plain details is possible, but requires permission from the compliance department.
For Tokenized payments and BanContact WIP payment, the field authentication_methods is required and cannot contain the value NOT_AUTHENTICATED. More details on how to use Tokenized payments can be found in the Tokenization guide.

Response Data

The response of a Start Payment request has the following structure.

Field	Type	M	Description
id	PaymentIdentifier	M	The payment identifier.
status	Enum(32)	M	The authorization status of the payment. See Authorization states for more detailed description.
urls	Block[]	C	Required for authorization states REDIRECTED_FOR_AUTHENTICATION and REDIRECTED_FOR_AUTHORIZATION.
url	Block	M	The redirect details for the shopper. Merchant should handle the redirect instructions. Otherwise, the payment will not complete.
+ purpose	Enum(64)	M	The purpose of this URL.
+ method	Enum(16)	M	The HTTP method to be used, either "GET" or "POST".
+ url	Url	M	The url the shopper must be redirected to.
+ order	Number(1, 10)	M	Order in which urls should be displayed or handled.
+ parameters	Map	O	Map with parameter name/values pairs for the body of the redirect request. The keys and values are of type String(1,255).
bank_transfer_details	Block	C	Bank transfer details for the shopper.
+ beneficiary_name	String(1, 35)	M	Beneficiary name.
+ beneficiary_city	String(1, 35)	M	Beneficiary city.
+ beneficiary_country	String(1, 35)	M	Beneficiary country.
+ bank_name	String(1, 105)	M	Bank name.
+ bank_city	String(1, 35)	M	Bank city.
+ bic	String(1, 12)	O	BIC.
+ iban	String(1, 128)	O	IBAN formatted.
+ address_line1	String(1, 35)	O	First address line with address of beneficiary bank.
+ address_line2	String(1, 35)	O	Second address line with address of beneficiary bank.
+ address_line3	String(1, 35)	O	Third address line with address of beneficiary bank.
+ address_line4	String(1, 35)	O	Fourth address line with address of beneficiary bank.
point_of_sale_details	Block	C	Point Of Sale details for the merchant.
+ wakeup	Block	M	Wake-up address details to wakeup terminal for contactless payments.
++ ip	String(1, 255)	M	Wake-up ip address of terminal in local network.
++ port	Number(0, 65535)	M	Wake-up port.

For the field purpose the following values are possible:

Purpose	Description and required actions
REDIRECT	Redirect the shopper to the specified URL using the given `method` and `parameters`.
HIDDEN_IFRAME	The URL must be loaded in an i-frame that is hidden from the shopper. The size of the i-frame can be 0x0 or 1x1 pixels.
IFRAME	The returned URL should not be loaded in an i-frame, but a POST request needs to be performed on it. The response of that request may need to be loaded inside an i-frame.

If the purpose is IFRAME, then (for now) 3DSv2 authentication needs to be performed. The URL points back to the Payment System to start the authentication and response contains additional instructions that need to be carried out. For more information see also Credit/Debit Card Authentication.

HTTP Status

Status	Meaning
201 (Created)	The payment is created.
202 (Accepted)	The payment is created and ended in canceled due to an error.
400 (Bad Request)	The request was not valid.
400 (Bad Request)	There was no web-direct route available.
403 (Forbidden)	The merchant key is not correct.
404 (Not Found)	The merchant reference for the subscription or the order key was not found.

Examples

iDeal payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/B72AD93F3CBFC47BB2173361D5DE573D/payments \
    -d '{
             "method" : "IDEAL"             
        }'
 
< Http 201 Created 
<    '{
        "id"        : "pid2163180628t",
        "status"    : "REDIRECTED_FOR_AUTHORIZATION",
        "urls"  : {
            "purpose": "REDIRECT",
            "method"    : "GET",
            "url"       : "https://secure.sandbox.pay.cm.com/ps_sim/idealbanksimulator.jsf?trxid=1489155977162&amp;ec=2163180628&amp;returnUrl=%2Fps_sim%2Fparameters.jsf%3FcheckDigitId%3D2163180628B72AD93F3CBFC47BB2173361D5DE573D&amp;status=pay",
            "order": 1
        }
     }'

iDeal FastCheckout payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/B72AD93F3CBFC47BB2173361D5DE573D/payments \
    -d '{
             "method" : "IDEAL",
             "request_shopper_details" : ["NAME", "PHONE", "EMAIL", "SHIPPING_ADDRESS", "BILLING_ADDRESS"]             
        }'
 
< Http 201 Created 
<    '{
        "id"        : "pid2163180628t",
        "status"    : "REDIRECTED_FOR_AUTHORIZATION",
        "urls"  : {
            "purpose": "REDIRECT",
            "method"    : "GET",
            "url"       : "https://secure.sandbox.pay.cm.com/ps_sim/idealbanksimulator.jsf?trxid=1489155977162&amp;ec=2163180628&amp;returnUrl=%2Fps_sim%2Fparameters.jsf%3FcheckDigitId%3D2163180628B72AD93F3CBFC47BB2173361D5DE573D&amp;status=pay",
            "order": 1
        }
     }'

PayPal payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/3B88E0EF13E37D6A56AE949AD9E56961/payments \
    -d '{
            "method"  : "PAYPAL",
        }'
 
< Http 201 Created 
<    '{
          "id": "pid160701764t",
          "status": "REDIRECTED_FOR_AUTHENTICATION",
          "urls": {
              "purpose": "REDIRECT",
              "method": "GET",
              "url": "https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&useraction=commit&token=EC-9WB291683P236782S",
              "order": 1
          }
      }'

Credit card payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/3B88E0EF13E37D6A56AE949AD9E56961 \
    -d '{
        "method": "MASTERCARD",
        "card_details": {
        "browser_information" : {
            "shopper_ip" : "0.0.0.0",
            "accept" : "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
            "user_agent" : "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.18363"
        },
       "plain_card_details": {
         "card_holder_name":"John Doe",
         "card_number":"5555 555 5555 54444",
         "card_expiry": {
            "month":"01",
            "year":"23"
         },
         "security_code":"123"
      }
   }
}'
 
< Http 201 Created
<    '{
    "id": "pid1607034399t",
    "status": "REDIRECTED_FOR_AUTHENTICATION",
    "urls": [
        {
            "purpose": "HIDDEN_IFRAME",
            "method": "POST",
            "url": "https://secure.sandbox.pay.cm.com/ps_sim/nca_sim/finger_print",
            "order": 1,
            "parameters": {
                "threeDSMethodData": "eyd0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMJzonaHR0cHM6Ly9kdW1teS5jb20vbm90aWZpY2F0aW9uLXVybCcsJ3RocmVlRFNTZXJ2ZXJUcmFuc0lEJzonYzY3NjUzNjItNDQ5Ni00YjUwLTkyYzItYmRhYmNhZDQ3ZWVmIn0="
            }
        },
        {
            "purpose": "IFRAME",
            "method": "POST",
            "url": "https://secure.sandbox.pay.cm.com/ps/api/public/3dsv2/v1/transactions/c6765362-4496-4b50-92c2-bdabcad47eef/references/1607034399/authenticate",
            "order": 2
        }
    ]
}'

> curl \
	-X POST \
	--header 'Content-Type: application/json' \
	--header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
	https://secure.sandbox.pay.cm.com/ps/api/public/orders/3B88E0EF13E37D6A56AE949AD9E56961 \
	-d '{
           "method": "MAESTRO",
           "card_details": {
        	  "browser_information" : {
                    "shopper_ip" : "0.0.0.0",
        	   		"accept" : "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
        	   		"user_agent" : "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.18363"
        	   },
              "encrypted_card_details": {
                 "data" : "AuPEzU8gUC3H/yXr7ZFnVK3KvdJYEfgbPLx/Ntb2LWOzrxElT5ueeijLVv9AKbKGpb1r9BcSdNB4CckxOm579L+ruCjK2gVKlKwaCPcHPy3bRHWOWBr+kcAAFwkHn1mCRIFmLXFtIBoukIT4pjdUygoQioEYZHymJu0FZGWIcHtZRevCTZr8tgLVYa3tM3ffqJ2wr2p+zDu++A4MVIN5IlhEp7zg75aZWWjmpIZj8M12Ne3EA4Sqzu01w3hxXpE6GbhSdnUQjR9Sde90ayGgaZtwbXy6Umy+boK2B7l4tRUvJAzqRoOG9F1GsH9gQs3O0DmtL/adClIr70Ue0ZCJNw==|Y2xpZW50c2lkZS00"
           }
       }
   }'

< Http 201 Created 
<	'{
         "id": "pid1607034038t",
         "status": "REDIRECTED_FOR_AUTHENTICATION",
         "urls": [
             {
                 "purpose": "HIDDEN_IFRAME",
                 "method": "POST",
                 "url": "https://secure.sandbox.pay.cm.com/ps_sim/nca_sim/finger_print",
                 "order": 1,
                 "parameters": {
                     "three_ds_method_data": "eyd0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMJzonaHR0cHM6Ly9kdW1teS5jb20vbm90aWZpY2F0aW9uLXVybCcsJ3RocmVlRFNTZXJ2ZXJUcmFuc0lEJzonYzA0YTZjMWEtZjZjYi00MWJmLWIyMTQtMTYwYjYwNDAzYWUwIn0="
                 }
             },
             {
                 "purpose": "IFRAME",
                 "method": "POST",
                 "url": "https://secure.sandbox.pay.cm.com/ps/public/3dsv2/transaction/c04a6c1a-f6cb-41bf-b214-160b60403ae0/1607034038",
                 "order": 2
         }
     ]
}'

Klarna Smooth payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/7E0D6CE5759AC785FC600C8C00AE0650/payments \
    -d '{
            "method"  : "KLARNA"
        }'
 
< Http 201 Created 
<    '{
           "id": "pid4911970290t",
           "status": "REDIRECTED_FOR_AUTHENTICATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "GET",
                   "url": "https://pay.playground.klarna.com/eu/hpp/payments/1ZTCX1Q",
                   "order": 1
               }
           ]
       }'

Przelewy24 & Blik payments

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/FC7B384453B0A73B85F6FA079E95EF1B/payments \
    -d '{
            "method"  : "PRZELEWY_24"
        }'
 
< Http 201 Created 
<    '{
           "id": "pid4911970328t",
           "status": "REDIRECTED_FOR_AUTHORIZATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "GET",
                   "url": "https://secure.sandbox.pay.cm.com/ps_sim/przelewy24/pay/trnRequest/619d5f28-7e0f-4465-9be1-28b31528063d",
                   "order": 1
               }
           ]
       }'

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/7B5AF2B4C4137C095C6045F0996EF4FE/payments \
    -d '{
            "method"  : "BLIK"
        }'
 
< Http 201 Created 
<    '{
           "id": "pid4911970344t",
           "status": "REDIRECTED_FOR_AUTHORIZATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "GET",
                   "url": "https://secure.sandbox.pay.cm.com/ps_sim/przelewy24/pay/trnRequest/8ee1d5f6-8b1c-4528-99f7-8a98a8e09fbb",
                   "order": 1
               }
           ]
       }'

ELV payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/B72AD93F3CBFC47BB2173361D5DE573D/payments \
    -d '{
             "method" : "ELV",
             "elv_payment_details" : {
                       "iban" : "DE64603900000272082007"
            }
        }'
 
< Http 201 Created 
<    '{
        "id"        : "pid2163180628t",
        "status"    : "AUTHORIZED",
     }'

Sofort Ueberweisung & Sofort E-banking payments

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic dGVzdHNob3A6d2RzWUZGUUw=' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/275e8be1-3b66-47ed-a6e9-bdb2c7c7d831/orders/F40CAD727061DB859DE93E93ADCD9079/payments' \
    -d '{
            "method": "SOFORT_UEBERWEISUNG"
        }'

< Http 201 Created
<    '{
           "id": "pid1607119702t",
           "status": "REDIRECTED_FOR_AUTHORIZATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "POST",
                   "url": "https://secure.sandbox.pay.cm.com/ps_sim/SofortSimulator?user_id=34196&project_id=252647&amount=33.3&currency_id=EUR&reason_1=PID1607119702T+ddp+testshop&reason_2=Order+12345&user_variable_0=1607119702&user_variable_1=159895246&user_variable_2=http%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromAuthorization%3FpaymentReference%3D1607119702F40CAD727061DB859DE93E93ADCD9079&user_variable_3=http%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromShopperCancelled%3FpaymentReference%3D1607119702F40CAD727061DB859DE93E93ADCD9079&language_id=NL&sender_country_id=DE&hash=c9f075ec78b32101db5f9a2fd4c01a93486d73689cbc2c2a0f7cd23bbe172a65",
                   "order": 1
               }
           ]
       }'

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic dGVzdHNob3A6d2RzWUZGUUw=' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/275e8be1-3b66-47ed-a6e9-bdb2c7c7d831/orders/B52B5826436F6CDC91A65E2BD78C5E7A/payments' \
    -d '{
            "method": "EBANKING"
        }'

< Http 201 Created
<    '{
           "id": "pid1607119725t",
           "status": "REDIRECTED_FOR_AUTHORIZATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "POST",
                   "url": "https://secure.sandbox.pay.cm.com/ps_sim/SofortSimulator?user_id=24105&project_id=203856&amount=33.3&currency_id=EUR&reason_1=PID1607119725T+ddp+testshop&reason_2=Order+12345&user_variable_0=1607119725&user_variable_1=159895251&user_variable_2=http%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromAuthorization%3FpaymentReference%3D1607119725B52B5826436F6CDC91A65E2BD78C5E7A&user_variable_3=http%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromShopperCancelled%3FpaymentReference%3D1607119725B52B5826436F6CDC91A65E2BD78C5E7A&language_id=NL&sender_country_id=DE&hash=1cb747c4e9684adcf7bd87fc778cc720786d7d6887ff6e8f9977abf71f438e28",
                   "order": 1
               }
           ]
       }'

IN3 payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/orders/63D742045C3580B50D35CF96691C6E0C/payments \
    -d '{
            "method"  : "IN_THREE", 
            "inthree_details" : {
                "shopper_ip" : "0.0.0.0"
            }
        }'
 
< Http 201 Created 
<    '{
           "id": "pid4914460071t",
           "status": "REDIRECTED_FOR_AUTHORIZATION",
           "urls": [
               {
                   "purpose": "REDIRECT",
                   "method": "GET",
                   "url": "https://test.docdatapayments.com/ps_sim/capayable/pay/46975c10-6ee5-4236-849d-5fd5b367fa59?returnUrl=https%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromAuthorization%3FpaymentReference%3D491446007163D742045C3580B50D35CF96691C6E0C&shopOrderExchangeUrl=https%3A%2F%2Fsecure.sandbox.pay.cm.com%2Fps%2FreturnFromShopperAbandoned%3FpaymentReference%3D491446007163D742045C3580B50D35CF96691C6E0C",
                   "order": 1
               }
           ]
       }'

Bank Transfer payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/B72AD93F3CBFC47BB2173361D5DE573D/payments \
    -d '{
             "method" : "BANK_TRANSFER",
             "bank_transfer_details" : {
                                 "email_address" : "[email protected]"
                               }
        }'
 
< Http 201 Created 
<    '{
          "id": "pid1607123245t",
          "status": "AUTHORIZED",
          "bank_transfer_details": {
              "beneficiary_name": "CM.com stichting",
              "beneficiary_city": "Utrecht",
              "beneficiary_country": "NL",
              "bank_name": "DEUTSCHE BANK A.G. AMSTERDAM ",
              "bank_city": "AMSTERDAM",
              "bic": "DEUTNL2A",
              "iban": "NL45DEUT0556977556",
              "address_line1": "POB 2065",
              "address_line2": "8022 ZURICH"
          }
      }'

Sepa Direct Debit payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/3B88E0EF13E37D6A56AE949AD9E56961/payments \
    -d '{
        "method"                    : "SEPA_DIRECT_DEBIT",
        "sepa_direct_debit_details" : {
                             "iban"     : "NL47INGB0007673523",
                             "bic"  : "RABONL2A",
                             "mandate"  : "mandateNumber"
        }
    }'
 
< Http 201 Created
<    '{
        "id"        : 2163179782,
        "status"    : "AUTHORIZED"
    }'

Point of sale payment

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://secure.sandbox.pay.cm.com/ps/api/public/v1/merchants/4ef08825-993a-424d-a769-3ee97116a1b6/orders/B72131B00298FA10A4396CD416DBC7EA/payments \
    -d '{
        "method"                    : "POINT_OF_SALE",
        "point_of_sale_details" : {
                             "terminal_id"     : "E_DDT1"
        }
    }'
 
< Http 201 Created
<    '{
        "id"        : pid1607193683t,
        "status"    : "AUTHORIZATION_REQUESTED",
        "point_of_sale_details": {
            "wakeup": {
                "ip": "127.0.0.1",
                "port": 8080
            }
        }
    }'

KBC & CBC payments

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://testsecure.docdatapayments.com/ps/api/public/orders/7B5AF2B4C4137C095C6045F0996EF4FE/payments \
    -d '{
            "method"  : "KBC"
        }'
 
< Http 201 Created 
<    '{
   		 "id": "pid4911970344t",
   		 "status": "REDIRECTED_FOR_AUTHORIZATION",
   		 "urls": [
        	{
           		 "purpose": "REDIRECT",
           		 "method": "GET",
            	 "url": "https://testsecure.docdatapayments.com/ps_sim/kbcacquirersimulator.jsf?langWebSite=N&amp;olpId=TODO&amp;olpCtx=vikIRmWLMoWtBnVEEb5x4r1KxbWTV%2BoV1mqnC9DeCkp6KJNFUdl639IIqnm7k9f5OHFXtl9OjIE6wgbvBICq04CKBZC8t%2F7bcV7atZyKXzWSGsDtbkGHxVNm5nuKOPyfl4eW8tnIFwG87R7fQaw0LSBmaGqVdtSiJfHaqyDPFZ4iNhSqM7bsbdWWJOpWC4VgEsxnwEF4Mym%2F0iDLbBx%2BzLaeDI43aTi47dr7DhsxKn%2BZKOR9IEdNrMUbVn%2F95Bssp6dmCpWT3w90gusH6VMq7VtJE3sxQGJZPTh6x7B1u%2BGz0shV1tHgYdiuHYa5dkIVeXsa819i9tjewjqs4cGSmWgpt%2B54ECGWty%2FyzOqjdkc4cXK3iIdlatxukxH1jEgPTw%2FzDREeyn3us9Xbr%2F0hHto%3D&amp;olpVer=3.0&amp;olpCompany=KBC",
            	 "order": 1
        	}
    	]
	}'

> curl \
    -X POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic RG9jZGF0YVBGOkJXazJhZkpV' \
    https://testsecure.docdatapayments.com/ps/api/public/orders/7B5AF2B4C4137C095C6045F0996EF4FE/payments \
    -d '{
            "method"  : "CBC"
        }'
 
< Http 201 Created 
<    '{
   		 "id": "pid4911970344t",
   		 "status": "REDIRECTED_FOR_AUTHORIZATION",
   		 "urls": [
        	{
           		 "purpose": "REDIRECT",
           		 "method": "GET",
            	 "url": "https://testsecure.docdatapayments.com/ps_sim/kbcacquirersimulator.jsf?langWebSite=N&amp;olpId=TODO&amp;olpCtx=vikIRmWLMoWtBnVEEb5x4r1KxbWTV%2BoV1mqnC9DeCkp6KJNFUdl639IIqnm7k9f5OHFXtl9OjIE6wgbvBICq04CKBZC8t%2F7bcV7atZyKXzWSGsDtbkGHxVNm5nuKOPyfl4eW8tnIFwG87R7fQaw0LSBmaGqVdtSiJfHaqyDPFZ4iNhSqM7bsbdWWJOpWC4VgEsxnwEF4Mym%2F0iDLbBx%2BzLaeDI43aTi47dr7DhsxKn%2BZKOR9IEdNrMUbVn%2F95Bssp6dmCpWT3w90gusH6VMq7VtJE3sxQGJZPTh6x7B1u%2BGz0shV1tHgYdiuHYa5dkIVeXsa819i9tjewjqs4cGSmWgpt%2B54ECGWty%2FyzOqjdkc4cXK3iIdlatxukxH1jEgPTw%2FzDREeyn3us9Xbr%2F0hHto%3D&amp;olpVer=3.0&amp;olpCompany=CBC",
            	 "order": 1
        	}
    	]
	}'

Start Payment with Referenced Order

Starts a payment via a referenced authorized payment, which allows shopper authentication to be skipped under specific circumstances.

The referenced payment is used to perform a follow-up payment based on an existing authorized payment. This start request can only be used for very specific use-cases, such as a 'no-show' in the hospitality sector or for additional fuel charges ('delayed-charges') in the car-rental sector. These payments/orders are also called merchant initiated transactions.

The usage of this request requires approval from the Compliance department.

The purpose of the referenced payment data is to skip the otherwise required strong shopper authentication (SCA). Only one exemption can be applied per referenced payment. It is not possible to perform a 'no-show'-payment and a 'delayed-charges'-payment which are both pointing to the same original payment.

POST /ps/api/public/v1/merchants/{merchant_key}/orders/{order_key}/payments/referenced