checkout-sdk 1.3.1

checkout.com python软件开发工具包

安装

pip install --upgrade checkout-sdk

来源：

python setup.py install

要求

• Python3.4+

用法

使用环境变量

os.environ['CKO_SECRET_KEY']='<your secret key>'os.environ['CKO_SANDBOX']='True|true|1'# else is False (Production)os.environ['CKO_LOGGING']='debug|DEBUG|info|INFO'# ...importcheckout_sdkassdkapi=sdk.get_api()

使用初始化值

importcheckout_sdkassdkapi=sdk.get_api(secret_key='<your secret key>')# default sandbox = True

设置默认值

sdk.default_currency=sdk.Currency.EURsdk.default_auto_capture=Truesdk.default_auto_capture_delay=0# valid: 0 - 168 (hours)sdk.default_payment_type=sdk.PaymentType.Regular

付款请求

全卡

try:payment=api.payments.request(card={'number':'4242424242424242','expiryMonth':6,'expiry_year':2025,# snake_case is auto converted'cvv':'100'},value=100,# centscurrency=sdk.Currency.USD,# or 'usd'customer='customer@email.com'# Email or Customer Id)print(payment.id)print(payment.card.id)print(payment.customer.id)print(payment.http_response.body)# JSON bodyexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

卡号

try:payment=api.payments.request(card='card_713A3978-AFB2-4D30-BF9A-BA55714DC309',value=100,# centscurrency=sdk.Currency.USD,# or 'usd'customer='customer@email.com'# Email or Customer Id)ifpayment.approved:# ...exceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

支付历史

获取历史记录

try:history=api.payments.history(payment_id)# charge_00000000000000000000forchargeinhistory.charges:print(charge.id)print(charge.created)print(charge.response_code)exceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

有关详细信息，请参见payment_history.py和charge.py。

3ds支持

支持3DS的完整卡

try:payment=api.payments.request(card={'number':'4242424242424242','expiryMonth':6,'expiryYear':2025,'cvv':'100'},value=100,currency=sdk.Currency.USD,customer='customer@email.com',charge_mode=sdk.ChargeMode.ThreeDS)print(payment.requires_redirect)# Trueprint(payment.id)# Payment Tokenprint(payment.redirect_url)# ACS Urlprint(payment.http_response.body)# JSON bodyexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

Important: If you use the Checkout.com Risk Engine to upgrade to a 3DS flow (from N3D) depending on criteria, you must always check for payment.requires_redirect first.

带3DS支持+N3D降级选项的完整卡

try:payment=api.payments.request(card={'number':'4242424242424242','expiryMonth':6,'expiryYear':2025,'cvv':'100'},value=5000,currency=sdk.Currency.USD,customer='customer@email.com',charge_mode=sdk.ChargeMode.ThreeDS,attempt_n3d=True)print(payment.downgraded)# Trueprint(payment.id)# Payment Tokenprint(payment.redirect_url)# Success/Confirmation Urlexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

Important: Value needs to be set to 5000 to simulate a 20153 response code on the Sandbox environment, which will then attempt an N3D charge.

替代付款

支付令牌请求

try:token=api.tokens.request_payment_token(value=100,# centscurrency=sdk.Currency.USD,# or 'usd'track_id='001',success_url='http://success.com',fail_url='http://retry.com')print(token.id)print(token.http_response.body)# JSON bodyexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

请求其他付款

# first, create a payment token as per the above code sampletry:payment=self.client.alternative_payment_request(apm_id=sdk.AlternativePaymentMethodId.IDEAL,payment_token=token.id,user_data={'issuerId':'INGBNL2A'},customer='joesmith@gmail.com'# Email or Customer Id)print(payment.requires_redirect)# Trueprint(payment.id)# Payment Tokenprint(payment.redirect_url)# Alternative Payment Urlprint(payment.http_response.body)# JSON bodyexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

其他付款信息

Important: Only iDEAL is supported at the moment when using alternative payment info.

try:info=self.client.alternative_payment_info(apm_id=sdk.AlternativePaymentMethodId.IDEAL)print(info.http_response.body)# JSON bodyexceptsdk.errors.CheckoutSdkErrorase:print('{0.http_status}{0.error_code}{0.elapsed}{0.event_id} // {0.message}'.format(e))

异常处理

classCheckoutSdkError(Exception):# catch allclassAuthenticationError(CheckoutSdkError):# 401classBadRequestError(CheckoutSdkError):# 400classResourceNotFoundError(CheckoutSdkError):# 404classTimeout(CheckoutSdkError):classTooManyRequestsError(CheckoutSdkError):# 422classApiError(CheckoutSdkError):# 500 / fallback

The SDK will not do any offline validation of card data, IDs, etc. Provided the values and types are correct, all business validations are handled at API level. On that note, expect ValueError and TypeError for incorrect usage.

处理API验证异常

API响应

{"eventId":"00000000-0000-0000-0000-000000000000","errorCode":"70000","message":"Validation error","errorMessageCodes":["70034","70013"],"errors":["Invalid card id","Invalid customer id"]}

异常处理

exceptsdk.errors.BadRequestErrorase:ife.validation_error:# error_code == 70000print(e.errors)# dictionary { msg_code: msg }formsg_codeine.errors:print(msg_code)# e.g. 70034print(e.errors[msg_code])# e.g. Invalid card id

记录

os.environ['CKO_LOGGING']='debug|DEBUG|info|INFO'

或者…

importlogginglogging.getLogger('cko').setLevel(logging.DEBUG)

测试套件

测试当前需要沙盒帐户。这最终将被传入的checkout.com mock api所取代。

export CKO_SECRET_KEY="<your secret key>"
export CKO_LOGGING="info|debug"
python setup.py test

标签：

• com
• id
• http
• sdk
• code
• 开发包
• payment
• checkout
• errors

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• extprot

  紧凑、高效、可扩展的二进制序列化格式

• dolmen.sqlcontainer

  Container Abstraction for Sqlalchemy

• signalfx-serverless-gcf

  signalfx python无服务器包装器

• large-image-source-mapnik

  用于大图像的mapnik/gdal tilesource

• django-ipauth

  Django的IP身份验证

• Experimentor

  用python进行的实验

• copytruncate

  文件另存后清空文件，保持文件inode不变。一般可用于大日志文件的交换等场景。

• file_encryptor

  用于聚合加密元磁盘使用的文件的工具。

• txcelery-py3

  Twisted的芹菜：使用延迟API管理Twisted中的芹菜任务

• oca

  xmlrpc opennebula云api的python绑定

• drudge

  苦工

• talke

  简单语音测试（TTS）接口库，支持多种语言和多引擎。

• knowyourdata

  显示数据基本信息的包

• simpleplotdigitizer

  简单的绘图数字化仪

• python-module-starter

  这个包为要构建的python包创建了一个框架。